home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / proboard / pb_215.zip / PB215.DOC < prev    next >
Text File  |  1996-05-05  |  412KB  |  10,792 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.       ▒▒▒▒▒▒▒▒▒▄                 ▒▒▒▒▒▒▒▒▒▄
  22.        ▒▒█▀▀▀▒▒█                  ▒▒█▀▀▀▒▒█
  23.        ▒▒█   ▒▒█ ▒▒▒▒▒▒▄ ▒▒▒▒▒▒▄  ▒▒█   ▒▒█ ▒▒▒▒▒▒▄ ▒▒▒▒▒▒▄ ▒▒▒▒▒▒▄ ▒▒▒▒▒▒▒▄
  24.        ▒▒▒▒▒▒▒▒█ ▒▒█▀▒▒█ ▒▒█▀▒▒█  ▒▒▒▒▒▒▒█▀ ▒▒█▀▒▒█ ▒▒█▀▒▒█ ▒▒█▀▒▒█  ▒▒█▀▒▒█
  25.        ▒▒█▀▀▀▀▀▀ ▒▒▒▒▒▒█ ▒▒█ ▒▒█  ▒▒█▀▀▀▒▒█ ▒▒█ ▒▒█ ▒▒▒▒▒▒█ ▒▒▒▒▒▒█  ▒▒█ ▒▒█
  26.        ▒▒█       ▒▒█▒▒█▀ ▒▒█ ▒▒█  ▒▒█   ▒▒█ ▒▒█ ▒▒█ ▒▒█▀▒▒█ ▒▒█▒▒█▀  ▒▒█ ▒▒█
  27.       ▒▒▒▒█      ▒▒█ ▒▒█ ▒▒▒▒▒▒█ ▒▒▒▒▒▒▒▒▒█ ▒▒▒▒▒▒█ ▒▒█ ▒▒█ ▒▒█ ▒▒█ ▒▒▒▒▒▒▒█
  28.        ▀▀▀▀       ▀▀  ▀▀  ▀▀▀▀▀▀  ▀▀▀▀▀▀▀▀▀  ▀▀▀▀▀▀  ▀▀  ▀▀  ▀▀  ▀▀  ▀▀▀▀▀▀▀
  29.  
  30.                            "The Choice of Professionals"
  31.                                    Version 2.15
  32.  
  33.                                  ++ May 5, 1996 ++
  34.  
  35.  
  36.                    Copyright (c) 1990-1996  Philippe Leybaert
  37.                                 All rights reserved.
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.          ───────────────────────────────────────────────────────────────────
  45.  
  46.          The following names/products mentioned in this documentation are
  47.          copyrighted material, trademarks or registered trademarks:
  48.  
  49.          Bimodem                    Erik Labs
  50.          BNU                        David Nugent/Unique Computing Pty Ltd.
  51.          Borland C++, Turbo C++     Borland International, Inc.
  52.          DESQview                   Quarterdeck Office Systems
  53.          DoorWay                    Marshall Dudley
  54.          FastEcho                   Software Technik Burchhardt
  55.          FidoNet                    Tom Jennings
  56.          GEcho                      Gerard van der Land
  57.          GChat/GEdit                Chris Patterson
  58.          IBM PC/XT/AT               International Business Machines, Inc.
  59.          LANtastic                  Artisoft Inc.
  60.          MBUTIL                     Gerard van der Land
  61.          Microsoft C                Microsoft, Inc.
  62.          Multi-Edit                 American Cybernetics, Inc.
  63.          Novell Lite                Novell Inc.
  64.          Opus                       Wynn Wagner III
  65.          QEMM                       Quarterdeck Office Systems
  66.          QuickBBS                   The QuickBBS Group, Inc.
  67.          QuickEd                    Tirosh Bros.
  68.          RIPscrip                   TeleGrafix Communications, Inc.
  69.          RemoteAccess (RA)          Wantree Development and Andrew Milner
  70.          Squish                     Scott J. Dudley
  71.          TheBank                    Alain Schellinck
  72.          TLIB                       Burton Systems Software
  73.          FrontDoor                  Joaquim H. Homrighausen
  74.          Turbo Assembler/Debugger   Borland International, Inc.
  75.          X00                        Ray Gwinn
  76.          ZmailH                     Claude N. Warren
  77.  
  78.          "JAM(mbp) - Copyright 1993 Joaquim Homrighausen, Andrew Milner,
  79.                                     Mats Birch, Mats Wallin.
  80.                                     ALL RIGHTS RESERVED."
  81.  
  82.          ───────────────────────────────────────────────────────────────────
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.                                       - 1 -
  95.  
  96.  
  97.  
  98.          ╔═════════════════════════════════════════════════════════════════╗
  99.          ╟─── IMPORTANT INFORMATION - READ THIS FIRST ─────────────────────╢
  100.          ╚═════════════════════════════════════════════════════════════════╝
  101.  
  102.  
  103.          - ProBoard (to include all executables and documentation files)
  104.            is copyrighted material of Philippe Leybaert.
  105.  
  106.          - You can use ProBoard for a period of 60 days, free of charge.
  107.            If you use the software after the evaluation period of 60 days,
  108.            you MUST register.  (For registration information, see the
  109.            appropriate section of this manual).
  110.  
  111.          - We reserve the right to quit giving support or releasing updates
  112.            of the software.  We also reserve the right to charge a nominal
  113.            upgrade fee for future versions.
  114.  
  115.          - The software and other materials included in the distribution
  116.            archive are provided "AS IS" without warranty of any kind.  We
  117.            do not guarantee the correct functioning and/or reliability of
  118.            the software.  The authors, or any agent of the authors will
  119.            not be liable for any direct or indirect damages, resulting
  120.            from the use of the software.
  121.  
  122.          - You may not reverse-engineer ProBoard in any way and you may not
  123.            add, change or delete any files in the distribution archive.
  124.  
  125.          - You are free to distribute the original, unmodified ProBoard
  126.            archive provided no fee is charged for its distribution.  This
  127.            excludes charges for online time on electronic bulletin boards
  128.            or other communication services.
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.                                       - 2 -
  151.  
  152.  
  153.  
  154.          ╔═════════════════════════════════════════════════════════════════╗
  155.          ╟─── Contents ────────────────────────────────────────────────────╢
  156.          ╚═════════════════════════════════════════════════════════════════╝
  157.  
  158.  
  159.                 INTRODUCTION ....................................   6
  160.                      - Description ..............................   6
  161.                      - Features .................................   7
  162.                      - Technical Info ...........................  10
  163.                      - Credits ..................................  11
  164.  
  165.                 SUPPORT .........................................  12
  166.                      - Local support sites ......................  12
  167.                      - Support on internet ......................  15
  168.                      - The Global ProBoard Network ..............  16
  169.  
  170.                 REGISTRATION ....................................  19
  171.  
  172.                 INSTALLATION ....................................  27
  173.                      - RemoteAccess to ProBoard conversion ......  27
  174.                      - RemoteAccess compatible files ............  28
  175.  
  176.                 STARTING PROBOARD ...............................  30
  177.  
  178.                 CONFIGURATION ...................................  32
  179.                      - Options (F1) .............................  32
  180.                      - Protocol Configuration (F2) ..............  47
  181.                          - The Local Protocol PEX ...............  51
  182.                      - Message Areas (F3) .......................  53
  183.                      - Message Area Groups (F4) .................  59
  184.                      - File Areas (F5) ..........................  60
  185.                      - File Area Groups (F6) ....................  64
  186.                      - Time/Download Limits (F7) ................  65
  187.                      - User Editor (F8) .........................  67
  188.                      - Menu Editor (F9) .........................  76
  189.                      - Matrix Addresses (F10) ...................  80
  190.                      - Modem Parameters (Shift-F1) ..............  81
  191.                      - SysOp Macros (Shift-F2) ..................  84
  192.                      - Events (Shift-F3) ........................  85
  193.                      - Personal Files (Shift-F4) ................  86
  194.                      - Language Editor (Shift-F5) ...............  88
  195.                      - Validate Template Editor (Shift-F6) ......  93
  196.                      - About ProCFG (Shift-F9) ..................  96
  197.  
  198.                 SECURITY ........................................  97
  199.                      - Levels & Flags ...........................  97
  200.                      - Trashcan .................................  97
  201.  
  202.  
  203.  
  204.  
  205.  
  206.                                       - 3 -
  207.  
  208.  
  209.  
  210.                 MENUS ...........................................  98
  211.                      - Setting up menus .........................  98
  212.                      - Menu Security ............................  99
  213.                      - Creating menus ........................... 100
  214.                      - Hints .................................... 103
  215.                      - Menu Function Summary .................... 104
  216.                      - Menu Function Overview ................... 106
  217.  
  218.                 RIPscrip GRAPHICS ............................... 151
  219.  
  220.                 FILE TAGGING .................................... 153
  221.  
  222.                 QWK ............................................. 154
  223.  
  224.                 USERS ........................................... 155
  225.                      - Loglevels ................................ 155
  226.  
  227.                 ECHOMAIL & NETMAIL .............................. 156
  228.                      - Echomail ................................. 156
  229.                      - Netmail .................................. 156
  230.  
  231.                 PBUTIL (The ProBoard Utility Program) ........... 158
  232.                      - Daily Maintenance ........................ 159
  233.                      - Fix BINLOG.PB ............................ 159
  234.                      - File Counters ............................ 159
  235.                      - File Indexer ............................. 160
  236.                      - Hatch Personal File ...................... 160
  237.                      - Message Indexer .......................... 162
  238.                      - Message Linker ........................... 162
  239.                      - Message Packer ........................... 162
  240.                      - Music Player ............................. 163
  241.                      - Nodelist Compiler ........................ 164
  242.                      - UserFile Fixer ........................... 165
  243.                      - UserFile Indexer ......................... 165
  244.                      - UserFile Killer .......................... 166
  245.                      - UserFile Packer .......................... 167
  246.                      - UserFile Sorter .......................... 167
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                                       - 4 -
  263.  
  264.  
  265.  
  266.                 REFERENCE ....................................... 168
  267.                      - Multi-user operation ..................... 168
  268.                      - SysOp keys ............................... 169
  269.                      - Command line options & errorlevels ....... 171
  270.                      - AVATAR/0 and AVATAR/0+ ................... 173
  271.                      - Hard-coded .A?? files .................... 174
  272.                      - .A?? file control codes .................. 177
  273.                      - Music Files .............................. 180
  274.                      - Text Macros .............................. 181
  275.                      - Example batch files ...................... 185
  276.                      - Flag Cross-Reference Chart ............... 187
  277.                      - FREE Files ............................... 188
  278.                      - Semaphore files (shutting down ProBoard) . 189
  279.  
  280.                 TIPS & TRICKS ................................... 190
  281.                      - Navigating through menus ................. 190
  282.                      - The [S] & [P] keys ....................... 190
  283.                      - Online help in every menu ................ 191
  284.                      - Uploading to the current file area ....... 191
  285.  
  286.                 SOFTWARE DEVELOPMENT KIT ........................ 192
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.                                       - 5 -
  319.  
  320.  
  321.  
  322.          ╔═════════════════════════════════════════════════════════════════╗
  323.          ╟─── INTRODUCTION ────────────────────────────────────────────────╢
  324.          ╚═════════════════════════════════════════════════════════════════╝
  325.  
  326.  
  327.          ┌─────────────────────────────────────────────────────────────────┐
  328.          │ Description                                                     │
  329.          └─────────────────────────────────────────────────────────────────┘
  330.  
  331.          ProBoard is a computer program that allows you to run a BBS.
  332.  
  333.          A BBS is a computerized Bulletin Board System, where files,
  334.          messages and other useful items may be exchanged between users.
  335.  
  336.          The operator of a BBS is called the System Operator, or SysOp.
  337.  
  338.          The SysOp is responsible for setting up and maintaining the BBS,
  339.          therefore, this manual is primarily geared towards the SysOp,
  340.          or people who are interested in becoming SysOps.
  341.  
  342.          ProBoard has everything you need to efficiently run a BBS, and
  343.          more!  It's state of the art technology allows you to run a BBS
  344.          without consuming large amounts of your hard disk space.
  345.  
  346.          ProBoard provides the ability to run a multi-node BBS, allowing
  347.          more than one user to be online at a time.  It's small size and
  348.          lightning fast speed make it ideal for running under a
  349.          multi-tasker like DESQview, or on a network.
  350.  
  351.          ProBoard also fully supports the ability to interface with mail
  352.          networks such as FidoNet, UseNet, EchoNet, and mail processors
  353.          such as SQUISH, FastEcho, GEcho, Fmail, and others.
  354.  
  355.          The greatest asset of ProBoard, is it's ability to be enhanced by
  356.          you the user, through the use of programs written in C/C++ using
  357.          the provided ProBoard SDK (Software Development Kit).  You can do
  358.          virtually anything with your BBS using the SDK and a C/C++
  359.          compiler.  Programs written with the ProBoard SDK are called PEX
  360.          (ProBoard Executable) files.  This built in "PEXability" assures
  361.          you that there's nothing ProBoard can't do!
  362.  
  363.          You do not have to be a C/C++ programmer to enjoy the benefits of
  364.          ProBoard's SDK or these PEX files.  There are many 3rd party PEX
  365.          files available for ProBoard right now with more being released
  366.          every day.
  367.  
  368.          Through it's SDK, ProBoard offers the user with a desire to learn
  369.          C/C++, the ability to do so with a more gentle learning curve.
  370.  
  371.  
  372.  
  373.  
  374.                                       - 6 -
  375.  
  376.  
  377.  
  378.          ProBoard has the ability to run most, if not all doors programs
  379.          and other utilities written for other BBS systems such as PCBoard,
  380.          QuickBBS (QBBS), SuperBBS, RemoteAccess (RA), etc.
  381.  
  382.          When running an external program, ProBoard can swap itself to
  383.          disk/EMS, and stay resident in approximately 2KB of memory!!
  384.  
  385.          ProBoard is highly configurable because it allows you to use
  386.          either the SQUISH, Fido Compatible *.MSG, JAM or the HUDSON
  387.          message base formats for the contents of your message base.
  388.          In addition to supporting all four of these formats for the message
  389.          base, ProBoard allows you to configure your BBS to use all
  390.          four at the same time.  Name one other BBS that allows you this
  391.          flexibility!
  392.  
  393.          Not flexible enough yet?  Consider then that ProBoard allows you
  394.          to configure up to 10,000 message areas, and additionally 10,000
  395.          file areas.  ProBoard also supports the use of CD-ROM drives.
  396.          Flexibility!!!
  397.  
  398.          Most, if not all, known utilities for RemoteAccess (RA) v1.11 as
  399.          well as RemoteAccess v2.x, will work with this version of ProBoard.
  400.  
  401.          ProBoard is remarkably easy to setup with the supplied PROCFG.EXE
  402.          file.  Most users are up and running within a few short painless
  403.          (even enjoyable) hours.
  404.  
  405.          We hope you will have as much fun running ProBoard as we did
  406.          developing it.
  407.  
  408.          Thank you for choosing ProBoard, "The Choice of Professionals".
  409.  
  410.  
  411.  
  412.          ┌─────────────────────────────────────────────────────────────────┐
  413.          │ Features                                                        │
  414.          └─────────────────────────────────────────────────────────────────┘
  415.  
  416.          This following is a list of the most important features found in
  417.          ProBoard.
  418.  
  419.          - ProBoard is THE fastest QuickBBS-style BBS program around!!
  420.            It's completely written in highly optimized C++ and assembly
  421.            language.
  422.  
  423.          - Full multi-line/multi-user support.  Up to 255 nodes can share
  424.            the same user database, message base and file database.  Each
  425.            node can have its own modem configuration, welcome screens,
  426.            menu structure, etc.
  427.  
  428.  
  429.  
  430.                                       - 7 -
  431.  
  432.  
  433.  
  434.          - Built-in fullscreen message editor.
  435.  
  436.          - Support for 4 message base types:  Squish, Hudson JAM and *.MSG,
  437.            all at the same time.
  438.  
  439.          - Support for up to 10,000 message areas and 10,000 file areas.
  440.  
  441.          - Compatible with most, if not all, doors written for other BBS
  442.            software such as RemoteAccess, QuickBBS, PCBoard, etc.
  443.  
  444.          - A software development kit is included with ProBoard!  You can
  445.            write your own extensions to ProBoard using C or C++.  Programs
  446.            written with the SDK run "inside" ProBoard, for maximum
  447.            flexibility and speed.  The programmer doesn't have to worry
  448.            about modem communications, user files, etc.  THIS IS TOTALLY
  449.            UNIQUE!!  No other BBS software offers anything that even comes
  450.            close.
  451.  
  452.          - Integrated, lightning-fast duplicate file checking on uploads.
  453.  
  454.          - Hooks for external upload checking programs.
  455.  
  456.          - Extremely fast indexed file system, while still using the
  457.            standard FILES.BBS-based file system.
  458.  
  459.          - Full CD-ROM support.  The CD-ROM drive is not accessed until a
  460.            file is actually downloaded.  It is only accessed to copy files
  461.            to a local drive of your choice freeing up the CD-ROM for other
  462.            requests.
  463.  
  464.          - Full alias (handle) support.
  465.  
  466.          - Flexible protocol configuration. You can install any protocol
  467.            directly in ProBoard (even bi-directional protocols are
  468.            supported).  Protocols that can be installed in ProBoard include
  469.            X/Y/Zmodem, MPT, Bimodem, HS/Link, etc.
  470.  
  471.          - Local up/downloads
  472.  
  473.          - Supports all types of modems.  All known connect rates are
  474.            directly supported, and you can specify up to 6 user-defined
  475.            connect rates.
  476.  
  477.          - Very flexible security system with over 65,000 security levels
  478.            and 32 security flags as well as "reverse" flags.
  479.  
  480.          - TTY, ANSI, Avatar (0 and 0+) terminal emulation.
  481.  
  482.          - Swaps itself to disk or EMS when shelling to an external program
  483.            (door), leaving only 2 (two) Kb resident!
  484.  
  485.  
  486.                                       - 8 -
  487.  
  488.  
  489.  
  490.          - REAL-TIME multi-line chat built in.  No stupid line-per-line
  491.            chat.
  492.  
  493.          - Direct support for all high speed modems (up to 115,200 bps).
  494.  
  495.          - Extremely user-friendly configuration/maintenance utilities.
  496.  
  497.          - Full RIP support, and unlike other BBS packages that leave the
  498.            SysOp looking at cryptic RIP codes, we even display the menus
  499.            your non-RIP callers see, on your end so you can see what's
  500.            happening on your BBS.
  501.  
  502.          - Built in file tagging system.
  503.  
  504.          - Users (and the SysOp) can send "personal files" to other users.
  505.            ProBoard automatically deletes the files after they have been
  506.            downloaded.
  507.  
  508.          - Automatic validation of users using a sophisticated "template"
  509.            system.
  510.  
  511.          - Powerful User Editor including filter function, allows you to
  512.            easily find and work with only the users you specify.
  513.  
  514.          - Ability to specify an external message editor either as door
  515.            or as a PEX file.
  516.  
  517.          - Ability to specify an external chat program, either as a door
  518.            or as a PEX file.
  519.  
  520.          - Fully "data driven" system usage graphs, even in RIP mode.
  521.  
  522.          - Ability to limit menu selections by age, baud rate, gender of
  523.            user, time online, or time of day.
  524.  
  525.          - Full Language support.  Every prompt in the system can be
  526.            changed (including color) and saved in a language file, as well
  527.            as multi-language support for menus and textfiles.  You can even
  528.            replace any prompt with ANSI files or PEX files.
  529.  
  530.          - Internal QWK support, provided as a PEX file for seamless
  531.            integration into your BBS.
  532.  
  533.          - User name can optionally be added to FILES.BBS when user
  534.            uploads files.
  535.  
  536.          - Powerful "Free Files" functions, great if you're running a
  537.            support BBS, or a BBS to promote your company.
  538.  
  539.          - Fully buffered I/O for optimum system performance.
  540.  
  541.  
  542.                                       - 9 -
  543.  
  544.  
  545.  
  546.          - Fully definable paging hours for every day of the week.
  547.  
  548.          - Support for OS/2 2.x time-slicing.
  549.  
  550.          - "SysOp Next" function, with definable "alert" music, as well
  551.            as semaphore file support.
  552.  
  553.          - Ability to call menu editor while user is online (or in local
  554.            mode) and edit the current menu.  Great for testing, or in case
  555.            you see something that just HAS to be fixed while a user is
  556.            online.
  557.  
  558.          - Built in file counters, shows which of your files are the most
  559.            popular.
  560.  
  561.          - Built in "flag description" editor, helps you remember just
  562.            what all of those flags you have are for.
  563.  
  564.          - Lots and lots more...
  565.  
  566.  
  567.  
  568.          ┌─────────────────────────────────────────────────────────────────┐
  569.          │ Technical Info                                                  │
  570.          └─────────────────────────────────────────────────────────────────┘
  571.  
  572.          ProBoard is entirely written in C++ and Assembler. No third-party
  573.          libraries are used (except for the Squish MSGAPI), so we have
  574.          TOTAL control over the code!
  575.  
  576.          For the development of ProBoard, we used the following tools:
  577.  
  578.          Compiler......... Borland C++ v3.1
  579.          Linker........... TLink, part of Borland C++ v3.1
  580.          Assembler........ Turbo Assembler v3.1
  581.          Debugger......... Turbo Debugger v3.1
  582.          Editor........... Multi-Edit Professional 6.1
  583.          Version Control.. TLIB v4.12f
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.                                       - 10 -
  599.  
  600.  
  601.  
  602.          ┌─────────────────────────────────────────────────────────────────┐
  603.          │ Credits                                                         │
  604.          └─────────────────────────────────────────────────────────────────┘
  605.  
  606.          ProBoard and all the included utilities are written by:
  607.          ───────────────────────────────────────────────────────
  608.  
  609.              Philippe Leybaert
  610.  
  611.  
  612.          Portions of ProCFG are also written by:
  613.          ───────────────────────────────────────
  614.  
  615.              Alain Schellinck
  616.  
  617.  
  618.          The ProBoard documentation is written by:
  619.          ─────────────────────────────────────────
  620.  
  621.              Jim Biggs & Philippe Leybaert
  622.  
  623.          Note from Jim:
  624.          ──────────────
  625.          This version of the documentation is dedicated to my late Father,
  626.          Richard Merle Biggs.  Dad, you will never ever be forgotten.
  627.  
  628.  
  629.          Beta-testing:
  630.          ────────────
  631.          Not enough appreciation can be expressed to the following ProBoard
  632.          SysOps who have helped to make ProBoard v2.15 what it is today.
  633.          They risked their entire BBS systems to help test this version.
  634.  
  635.          Many of their suggestions are contained in this release of
  636.          ProBoard and without them, this version would not be in your
  637.          hands today.
  638.  
  639.          Thanks to the entire ProBoard v2.15 Beta Team!!!
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.                                       - 11 -
  655.  
  656.  
  657.  
  658.          ╔═════════════════════════════════════════════════════════════════╗
  659.          ╟─── SUPPORT ─────────────────────────────────────────────────────╢
  660.          ╚═════════════════════════════════════════════════════════════════╝
  661.  
  662.  
  663.          ┌─────────────────────────────────────────────────────────────────┐
  664.          │ Local support sites                                             │
  665.          └─────────────────────────────────────────────────────────────────┘
  666.  
  667.          For problems, bug-reports, etc. please write to:
  668.          ────────────────────────────────────────────────
  669.  
  670.          ProBoard International             ProBoard USA #1
  671.          ──────────────────────             ───────────────
  672.          Philippe Leybaert                  Ken Givens
  673.          Groenplein 15                      2735 Stemmons Freeway
  674.          B-9060 Zelzate                     Dallas, TX 75207
  675.          BELGIUM                            USA
  676.  
  677.          ProBoard USA #2                    ProBoard Germany
  678.          ───────────────                    ────────────────
  679.          Chuck King                         Constantin Spiess
  680.          4810 Reginald Drive                Orchideenweg 15
  681.          Wichita Falls, TX 76308-5105       D-70736 Fellbach
  682.          USA                                Germany
  683.  
  684.          ProBoard UK                        ProBoard Australia
  685.          ───────────                        ──────────────────
  686.          Sarah Pearson                      Brett Wilkinson
  687.          7 Stopford Road                    P.O. Box 1786
  688.          Plaistow E13 0LY                   Macquarie Centre
  689.          United Kingdom                     North Ryde, NSW 2113
  690.                                             Australia
  691.  
  692.  
  693.          Or you can fax to the following numbers:
  694.          ────────────────────────────────────────
  695.  
  696.          USA/Canada       : (214) 905-3629
  697.          Germany          : +49-(0)711-95182-76
  698.          Rest of the world: +32-9-343-0592
  699.  
  700.  
  701.          You can also reach the author and support team by sending E-mail:
  702.          ─────────────────────────────────────────────────────────────────
  703.  
  704.          - Philippe Leybaert : - FidoNet    : 2:291/1905
  705.                                - CompuServe : 70314,2021)
  706.                                - InterNet   : philippe@proboard.be
  707.  
  708.  
  709.  
  710.                                       - 12 -
  711.  
  712.  
  713.  
  714.          - Ken Givens        : - FidoNet    : 1:124/2213
  715.                                - Internet   : kgivens@whytel.com
  716.  
  717.          - Chuck King        : - FidoNet    : 1:3805/3
  718.                                - Internet   : chuckking@cyberstation.net
  719.  
  720.          - Constantin Spiess : - FidoNet    : 2:246/1013
  721.                                - PB-NET     : 246:6106/0
  722.                                - Internet   : cns@mars.gp.schwaben.de
  723.  
  724.          - Sarah Pearson     : - FidoNet    : 2:254/278
  725.                                - Internet   : sysops@fe-line.demon.co.uk
  726.  
  727.          - Brett Wilkinson   : - FidoNet    : 3:711/950
  728.                                - Internet   : brett@unsw.edu.au
  729.  
  730.          - Eddie van Loon    : - FidoNet    : 2:284/407
  731.                                - DqP Net    : 173:100/1
  732.  
  733.  
  734.          If you have any questions or comments, or you need utilities for
  735.          ProBoard, call one of these support bulletin boards:
  736.  
  737.          - ProBoard Support/Registration USA
  738.  
  739.              SysOp   : Ken Givens
  740.              Hours   : 24/24
  741.              BBS     : (214) 641-1136 (V34)
  742.              FAX     : (214) 905-3629
  743.              Fido    : 1:124/2213
  744.              Internet: kgivens@whytel.com
  745.  
  746.  
  747.          - The Home of ProBoard - Worldwide ProBoard Support/Registration
  748.  
  749.              SysOp   : Philippe Leybaert
  750.              BBS #   : +32-9-343-8886 (V34 & ISDN X.75)
  751.              FidoNet : 2:291/1905
  752.              Internet: philippe@proboard.be (as of June 1st 1996)
  753.  
  754.            (note: to receive a reply to FidoNet netmail, poll back 48
  755.             ────  hours after you sent the message.  I will only reply
  756.                   to crashmail, NOT to routed netmail)
  757.  
  758.  
  759.          - Base 999 - ProBoard Support Luxembourg
  760.  
  761.              SysOp   : Alain Fontaine
  762.              BBS #   : +352-95273 (V34)
  763.              FidoNet : 2:270/24
  764.  
  765.  
  766.                                       - 13 -
  767.  
  768.  
  769.  
  770.          - The Dealer's BBS, ProBoard Support/Registration Germany
  771.  
  772.              SysOp   : Constantin Spiess
  773.              BBS #   : +49-(0)711-95182-77 (ZyXEL)
  774.                      : +49-(0)711-95182-78 (V34/ISDN)
  775.              FidoNet : 2:246/1013
  776.  
  777.  
  778.          - Fe-line BBS, ProBoard Support/Registration UK
  779.  
  780.              SysOp   : Sarah Pearson
  781.              BBS #   : +44-181-471-6928 (V34)
  782.              FidoNet : 2:254/278
  783.              DqP-Net : 173:902/107
  784.              Internet: sysops@fe-line.demon.co.uk
  785.  
  786.  
  787.          - Demolition BBS, ProBoard Support/Registration The Netherlands
  788.  
  789.              SysOp   : Eddie van Loon
  790.              BBS #   : +31-40-2573503 (VFC)
  791.                        +31-40-2550265 (VFC)
  792.              FidoNet : 2:284/407
  793.  
  794.  
  795.          - Eternal Entropy BBS, ProBoard Support/Registration Australia
  796.  
  797.              SysOp   : Brett Wilkinson
  798.              BBS #   : +61-2-878-4666
  799.              FidoNet : 3:711/950
  800.              Internet: brett@unsw.edu.au
  801.  
  802.  
  803.          There is also an International FidoNet ProBoard Support echo
  804.          conference available.  Be sure to ask your Net Coordinator about
  805.          it.  The name of the support echo conference is "PROBOARD".
  806.  
  807.          We do try very hard, but due to the volume of support requests that
  808.          we receive from registered users, we can only offer limited
  809.          support to non-registered users.
  810.  
  811.          For the latest version of ProBoard and utilities, you can call one
  812.          of the support boards (above).
  813.  
  814.          ProBoard is also available on CompuServe (IBMBBS forum).
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.                                       - 14 -
  823.  
  824.  
  825.  
  826.          ┌─────────────────────────────────────────────────────────────────┐
  827.          │ Support on the internet                                         │
  828.          └─────────────────────────────────────────────────────────────────┘
  829.  
  830.          There are many WWW and FTP sites available on the internet.  Many
  831.          of them are maintained by independent ProBoard-gurus.
  832.  
  833.          The "official" ProBoard WWW home page is:
  834.  
  835.                 http://www.proboard.be
  836.  
  837.          (note: this site will be active as of June 1st, 1996)
  838.  
  839.  
  840.          The following is a list of some (not all) known ProBoard WWW sites:
  841.  
  842.              ftp://ftp.shsu.edu/pub/proboard    Lots of ProBoard Files
  843.                                                 although none of the more
  844.                                                 recent files are there.
  845.                                                 Maintained by Alvin Brinson
  846.  
  847.              http://www.webstar.net/sci         WWW site home of Silicon
  848.                                                 Creations Inc.  Lots of
  849.                                                 ProBoard files from Silicon
  850.                                                 Creations Inc.  Updated
  851.                                                 regularly.  Maintained by
  852.                                                 Branislav Slantchev.
  853.  
  854.              http://www.whytel.com/users/kgivens/  Lots of information
  855.                                                    about Registering
  856.                                                    ProBoard in the USA.
  857.                                                    Maintained by Ken Givens.
  858.  
  859.              http://www.westvirginia.com/mjenkins  List of BBSes that
  860.                                                    Support ProBoard. Ideal
  861.                                                    site for when you are
  862.                                                    looking for some support
  863.                                                    in your area. Maintained
  864.                                                    by Matt Jenkins (Doorway
  865.                                                    BBS).
  866.  
  867.              http://www.iaehv.nl/users/edvloon  WWW site home of DqP. Lots
  868.                                                 of PEXs as well as
  869.                                                 information on how to
  870.                                                 register ProBoard in the
  871.                                                 Netherlands.  Maintained by
  872.                                                 Eddie Van Loon.
  873.  
  874.              http://www.aye.net/~jamaddox/      John Maddox's ProBoard Home
  875.                                                 Page.
  876.  
  877.  
  878.                                       - 15 -
  879.  
  880.  
  881.  
  882.              ftp://ftp.win.net/winnet/jamaddox/ John Maddox's ProBoard FTP
  883.                                                 Area.
  884.  
  885.              http://www.dma.be/p/bewoner/jmj/   JMJ Enterprises - Populare
  886.                                                 PEXes.
  887.  
  888.  
  889.  
  890.  
  891.          ┌─────────────────────────────────────────────────────────────────┐
  892.          │ The Global ProBoard Network                                     │
  893.          └─────────────────────────────────────────────────────────────────┘
  894.  
  895.          The Global ProBoard Network (TGPBN) is an amateur network built
  896.          around the FidoNet-style mailing systems. If you are a member of
  897.          FidoNet (or compatible network), you can easily set up your system
  898.          to be a part of TGPBN.
  899.  
  900.          TGPBN exists to provide ProBoard sysops around the world access to
  901.          the many PEXs and utilities that are available.  Many sysops have
  902.          been missing out due to the limitations of the existing ProBoard
  903.          Networks and whether they can receive it in their Country.
  904.  
  905.          TGPBN utilises the Internet as a means of distribution for Zone
  906.          Coordinators and it may be possible at a later date for everyone
  907.          who has access to the Internet to download files and echomail
  908.          packets from an FTP site using a fakenet address.
  909.  
  910.          TGPBN will try to hatch all the files that are written for
  911.          ProBoard.  If you have written a utility for ProBoard then just
  912.          pass it on to your nearest Host or Regional coordinator for
  913.          hatching.
  914.  
  915.          TGPBN is the only ProBoard network that has the full backing of
  916.          the author, Philippe Leybaert, and also is the basis for the
  917.          ProBoard FDN.
  918.  
  919.          TGPBN has already linked many countries together and some
  920.          previously had no contact with other PB Sysops *at all*.
  921.  
  922.          TGPBN is not the work of one person, but is a combined effort
  923.          between Faye and Sarah Pearson, Branislav Slantchev and by many
  924.          helpful people worldwide.
  925.  
  926.          You can obtain the latest information about TGPBN from :
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.                                       - 16 -
  935.  
  936.  
  937.  
  938.              Fe-line   : 44-181-548-9620
  939.              Sysop     : Sarah Pearson
  940.              Freq      : GPB-INFO.RAR
  941.              Networks  : 2:254/278@fidonet, 311:21/0@psn, 173:902/300@dqp
  942.              Internet  : http://www.win-uk.net/~fe-line
  943.                           ftp://ftp.win-uk.net/pub/users/fe-line
  944.  
  945.              Silicon Creations : 1-915-949-4798
  946.              Sysop             : Branislav Slantchev
  947.              Freq              : GPB-INFO.RAR
  948.              Networks          : 1:383/47@fidonet
  949.              Internet          : sci@webstar.net
  950.                                  http://www.webstar.net/sci
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.                                       - 17 -
  991.  
  992.  
  993.  
  994.          ╔═════════════════════════════════════════════════════════════════╗
  995.          ╟─── ProBoard v2.15 Beta Sites ───────────────────────────────────╢
  996.          ╚═════════════════════════════════════════════════════════════════╝
  997.  
  998.  
  999.          ──────────────────────  ────────────────────────────   ────────────
  1000.          SysOp Name              System Name                    Fido Address
  1001.          ──────────────────────  ────────────────────────────   ────────────
  1002.          Ken Givens              The Chess Board                1:124/2213
  1003.          Steve Quarrella         Valencia                       1:124/9005
  1004.          Mark Hopkins            Atlanta Information System     1:133/1
  1005.          Kitt Brown              <<(((KABOODLE)))>>             1:133/3003
  1006.          Eddie Watson            The Boll Weevils Hideaway      1:133/5
  1007.          Brian Hertziger         Mr. Homies' Neighborhood       1:154/645
  1008.          Lucien Carrier          Luca SBE!                      1:167/820
  1009.          John/Doris Bierrie      Doc's Place BBS                1:232/39
  1010.          John A. Maddox          Mount Olympus                  1:2320/340
  1011.          Paula Pautler           Candi Land BBS                 1:2380/120
  1012.          Perry Davis             Kings Knights BBS              1:243/38
  1013.          Brian McDermott         Nightmare Cafe                 1:247/103
  1014.          Roland Clairvoyant      Magog Online                   1:257/90
  1015.          Shawn Mazzuto           The Prime Directive            1:259/136
  1016.          Ron/Monica-Leeh Grayum  The Abyss BBS                  1:271/666
  1017.          Brient Leslie           The Dugout BBS                 1:280/33
  1018.          Jim Biggs               The O-Zone BBS                 1:282/30
  1019.          Chris Ament             Random Access BBS              1:282/3030
  1020.          John Parlin             City Terminal                  1:282/4021
  1021.          Robert Kemp             The Wild West BBS              1:282/4058
  1022.          Craig Peterson          FlightLine BBS                 1:282/47
  1023.          Tom Krueger             The Senate Chamber             1:282/56
  1024.          Paul Tabara             Rivendell BBS                  1:282/90
  1025.          Jeff Parr               Lightning Heart BBS            1:291/8
  1026.          Eric Chew               The Kat's Den BBS              1:324/274
  1027.          David Silver            The Silverado                  1:3618/11
  1028.          Bill Wenzel             Compu-Link                     1:363/1571
  1029.          James Padgett           Logical Decisions BBS          1:363/308
  1030.          Andy Smith              The Business Connection        1:3645/10
  1031.          Bob Pruett              Penguin Lust BBS               1:3660/812
  1032.          Mike Whatley            Th' Swamp Ward BBS             1:3660/814
  1033.          Greg Shaffer            Route 66 BBS                   1:370/510
  1034.          John Struemph           Kludger's Konnection BBS       1:383/22
  1035.          Bill Brooks             Come Consult with Us BBS       1:395/3
  1036.          Hank Bragg              The House of Golem             1:395/421
  1037.          Steven Williams         the River Styx                 1:395/61
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.                                       - 18 -
  1047.  
  1048.  
  1049.  
  1050.          Bert Rose               Stonebridge BBS                2:241/1017
  1051.          Peter Hampf             Granny's Inn, O/T-HQ           2:241/1090
  1052.          Bernd Rothbrust         Bernds Box                     2:241/555
  1053.          Henning Roll            Camelot                        2:2448/116
  1054.          Reiner Worm             Emil                           2:2448/2431
  1055.          Ralf Friedrich          Unknown BBS                    2:2448/311
  1056.          Dieter Schauf           DOENE                          2:2452/165
  1057.          Christian Raatz         AIRPORT                        2:246/1001
  1058.          Constantin Spiess       The Dealer's BBS               2:246/1013
  1059.          Heiko Raff              BASIS                          2:246/1015
  1060.          Thomas Holzwarth        microTalk IV                   2:246/1517
  1061.          Michael Folz            creative.box                   2:246/8704
  1062.          Andreas Klein           Alpha's Node                   2:2480/47
  1063.          Felix Mueller           FRISCO BBS Munich              2:2480/903
  1064.          Oliver Weindl           Programmer's Inn               2:2494/17
  1065.          Eddie Van Loon          Demolition BBS                 2:284/407
  1066.          Steven Debruyn          Magic BBS                      2:291/1200
  1067.          Dimitri v/d Ville       Zyllex BBS                     2:291/1301
  1068.          Tim De Meyer            MultiNet Home Base             2:291/1400
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.                                       - 19 -
  1103.  
  1104.  
  1105.  
  1106.          ╔═════════════════════════════════════════════════════════════════╗
  1107.          ╟─── REGISTRATION ────────────────────────────────────────────────╢
  1108.          ╚═════════════════════════════════════════════════════════════════╝
  1109.  
  1110.  
  1111.          ProBoard is SHAREWARE.  This means that you are granted a 60-day
  1112.          evaluation period, after which you must register.
  1113.  
  1114.          After receiving your registration, you will receive a registration
  1115.          key file through netmail or you will be able to download it from
  1116.          the support BBS where you sent the registration to (please
  1117.          indicate your preference on the registration form).
  1118.  
  1119.          If none of this is possible, we will send you a disk with
  1120.          the key file.  This will cost a little more (see below) and
  1121.          it will also take longer to receive your key (1-3 weeks).  You can
  1122.          indicate what size diskette you need on the registration form.
  1123.  
  1124.          Registration fees for commercial and non-commercial use are as
  1125.          follows:
  1126.                               ┌──────────┬──────────┬──────────┬──────────┐
  1127.                               │ Personal │ Personal │ Personal │Commercial│
  1128.                               │          │ w/manual │  (disk)  │ w/manual │
  1129.          ┌────────────────────┼──────────┼──────────┼──────────┼──────────┤
  1130.          │ USA & Canada       │   60 US$ │   80 US$ │   70 US$ │  299 US$ │
  1131.          ├────────────────────┼──────────┼──────────┼──────────┼──────────┤
  1132.          │ Belgium            │ 2000 BF  │ 2500 BF  │ 2200 BF  │10000 BEF │
  1133.          ├────────────────────┼──────────┼──────────┼──────────┼──────────┤
  1134.          │ The Netherlands    │  110 FL  │  140 FL  │  120 FL  │  599 FL  │
  1135.          ├────────────────────┼──────────┼──────────┼──────────┼──────────┤
  1136.          │ Germany            │  110 DM  │  140 DM  │  120 DM  │  649 DM  │
  1137.          ├────────────────────┼──────────┼──────────┼──────────┼──────────┤
  1138.          │ United Kingdom     │   40 £   │   50 £   │   45 £   │  200 £   │
  1139.          ├────────────────────┼──────────┼──────────┼──────────┼──────────┤
  1140.          │ South Africa       │  200 R   │  280 R   │  220 R   │ 1000 R   │
  1141.          ├────────────────────┼──────────┼──────────┼──────────┼──────────┤
  1142.          │ R.O.C. (Taiwan)    │ 2100 NT  │ 2700 NT  │ 2300 NT  │11400 NT  │
  1143.          ├────────────────────┼──────────┼──────────┼──────────┼──────────┤
  1144.          │ Australia          │   75 AU$ │  100 AU$ │   85 AU$ │  349 AU$ │
  1145.          └────────────────────┴──────────┴──────────┴──────────┴──────────┘
  1146.  
  1147.          One note about the difference between the commercial and
  1148.          non-commercial (personal) registration: non-commercial (personal)
  1149.          registrations are ONLY for individuals who run a BBS as a HOBBY.
  1150.          Registrations for all other BBSs require a commercial
  1151.          registration.  Commercial registration prices are EXCLUDING local
  1152.          taxes (VAT/TVA/BTW/...)
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.                                       - 20 -
  1159.  
  1160.  
  1161.  
  1162.          To register, print the registration form on the next page, fill it
  1163.          out, and send it together with your payment to one of the
  1164.          registration sites listed below.  You can register directly in the
  1165.          following countries (for other countries, see "other countries"):
  1166.                 - U.S.A.
  1167.                 - Canada
  1168.                 - Germany
  1169.                 - Australia
  1170.                 - The Netherlands
  1171.                 - Belgium
  1172.  
  1173.          If you want to register by transferring money to any of the
  1174.          ProBoard accounts in Europe, be certain you don't forget to mail a
  1175.          registration form to the address listed along with the account
  1176.          number, or you can upload/FAX it to the registration site for your
  1177.          area.  We can not and will not be responsible for any money
  1178.          received without a registration form.
  1179.  
  1180.          Starting with version 2.15, there will be several regional
  1181.          registrations sites in the U.S.  They are all listed below.
  1182.  
  1183.          ───────────────────────────────────────────────────────────────────
  1184.          For the U.S.A. and Canada (Registration Site #1)
  1185.  
  1186.             The Chess Board
  1187.             c/o Ken Givens
  1188.             2735 Stemmons Freeway
  1189.             Dallas, TX 75207
  1190.             USA
  1191.  
  1192.             Fax #   : (214) 905-3629
  1193.             BBS #   : (214) 641-1136
  1194.  
  1195.             FidoNet : 1:124/2213
  1196.             Internet: kgivens@whytel.com
  1197.  
  1198.          We accept Visa, MasterCard, personal checks and money orders.
  1199.          U.S. currency only please.  Do not send cash!!
  1200.  
  1201.          Please make checks and money orders payable to:
  1202.  
  1203.             Ken Givens
  1204.          ───────────────────────────────────────────────────────────────────
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.                                       - 21 -
  1215.  
  1216.  
  1217.  
  1218.          ───────────────────────────────────────────────────────────────────
  1219.          For the U.S.A. and Canada (Registration Site #2)
  1220.  
  1221.             Silverado Online
  1222.             c/o Chuck King
  1223.             4810 Reginald Drive
  1224.             Wichita Falls, TX 76308-5105
  1225.             USA
  1226.  
  1227.             Fax #   : (817) 691-7315
  1228.             BBS #   : (817) 691-9251
  1229.                       (817) 691-8119
  1230.  
  1231.             FidoNet : 1:3805/3
  1232.                       1:2805/17
  1233.             Internet: chuckking@cyberstation.net
  1234.  
  1235.          We accept Visa, MasterCard, personal checks and money orders.
  1236.          U.S. currency only please.  Do not send cash!!
  1237.  
  1238.          Texas residents MUST add an additional 6% sales tax.
  1239.  
  1240.          Please make checks and money orders payable to:
  1241.  
  1242.             Silverado Online
  1243.          ───────────────────────────────────────────────────────────────────
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.                                       - 22 -
  1271.  
  1272.  
  1273.  
  1274.          ───────────────────────────────────────────────────────────────────
  1275.          For Germany :
  1276.  
  1277.             ProBoard Germany
  1278.             c/o Constantin Spiess
  1279.             Orchideenweg 15
  1280.             D-70736 Fellbach
  1281.             GERMANY
  1282.  
  1283.             Fax #   : +49-(0)711-95182-76
  1284.             BBS #   : +49-(0)711-95182-77 (ZyXEL 19k2)
  1285.                       +49-(0)711-95182-78 (V34/ISDN)
  1286.  
  1287.             FidoNet : 2:246/1013  (ZyXEL 19k2)
  1288.                       2:246/1033  (V34/ISDN)
  1289.             PB-Net  : 246:6106/1001
  1290.             Internet: cns@mars.gp.schwaben.de
  1291.  
  1292.             Bank Account Number:
  1293.             KSK Fellbach , KtoNr: 2076692 , BLZ: 602 500 10
  1294.  
  1295.          Send money order or check in German currency (DM) only please!
  1296.          You can also transfer the money to our account number listed
  1297.          above.  We also accept Visa and MasterCard.
  1298.  
  1299.          Note: The price for the commercial version is without VAT (Preis
  1300.                ohne MWSt.)
  1301.          ───────────────────────────────────────────────────────────────────
  1302.  
  1303.          ───────────────────────────────────────────────────────────────────
  1304.          For The U.K.:
  1305.  
  1306.             ProBoard UK
  1307.             c/o Sarah Pearson
  1308.             7 Stopford Road
  1309.             Plaistow E13 0LY
  1310.             United Kingdom
  1311.  
  1312.             BBS #   : +44-181-471-6928 (V34)
  1313.  
  1314.             FidoNet : 2:254/278
  1315.             Internet: sysops@fe-line.demon.co.uk
  1316.  
  1317.             Bank Account Number:
  1318.                 30-92-90 (Sort Code)      7207547 (Account Num.)
  1319.  
  1320.          Send cash, cheque or postal order in UK currency (£) only please!
  1321.          You can also transfer the money to our account number listed
  1322.          above.
  1323.          ───────────────────────────────────────────────────────────────────
  1324.  
  1325.  
  1326.                                       - 23 -
  1327.  
  1328.  
  1329.  
  1330.          ───────────────────────────────────────────────────────────────────
  1331.          For Australia:
  1332.  
  1333.             ProBoard Australia
  1334.             c/o Brett Wilkinson
  1335.             P.O. Box 1786
  1336.             Macquarie Centre
  1337.             North Ryde, NSW 2113
  1338.             Australia
  1339.  
  1340.             BBS #   : +61-47-32-1417
  1341.             FidoNet : 3:713/320
  1342.             Internet: brett@unsw.edu.au
  1343.  
  1344.          Send money order or check in Australian Dollars only please!
  1345.          ───────────────────────────────────────────────────────────────────
  1346.  
  1347.          ───────────────────────────────────────────────────────────────────
  1348.          For The Netherlands :
  1349.  
  1350.             DEMOLITION BBS
  1351.             c/o Eddie van Loon
  1352.             Postbus 8697
  1353.             5605 KR Eindhoven
  1354.             THE NETHERLANDS
  1355.  
  1356.             BBS #     : +31-40-2573503
  1357.                         +31-40-2550265
  1358.             FidoNet   : 2:284/407
  1359.  
  1360.             Bank Account Number (SnS): 86.35.85.175
  1361.             Giro account             : 51.30.3.14
  1362.  
  1363.             (transfer money to "E. van Loon", with description "PROBOARD")
  1364.  
  1365.          Send money order or check in Dutch (FL) currency only please!  You
  1366.          can also transfer the money to our account numbers listed above.
  1367.          ───────────────────────────────────────────────────────────────────
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.                                       - 24 -
  1383.  
  1384.  
  1385.  
  1386.          ───────────────────────────────────────────────────────────────────
  1387.          For Belgium and all other countries:
  1388.  
  1389.             Philippe Leybaert
  1390.             Groenplein 15
  1391.             B-9060 Zelzate
  1392.             BELGIUM
  1393.  
  1394.             Fax #     : +32-9-343-0592
  1395.             BBS #     : +32-9-343-8886
  1396.             FidoNet   : 2:291/1905
  1397.             Internet  : philippe@proboard.be (as of June 1st 1996)
  1398.             CompuServe: 70314,2021
  1399.  
  1400.             Bank Account Number (BF) :  Kredietbank 449-2761441-25
  1401.             Bank Account Number (US$):  Kredietbank 449-2761440-24
  1402.  
  1403.          Send international money order or check (EuroCheque preferred) in
  1404.          Belgian currency (BF) only please! (refer to the registration fee
  1405.          table above).  International money orders are accepted in U.S.
  1406.          Dollars also.  You can also transfer the money to our account
  1407.          number listed above.  We also accept Visa and MasterCard/EuroCard.
  1408.          ───────────────────────────────────────────────────────────────────
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.                                       - 25 -
  1439.  
  1440.  
  1441.  
  1442.          ------------------------------------------------------------------
  1443.                ProBoard version 2.15     ----     Registration Form
  1444.          ------------------------------------------------------------------
  1445.  
  1446.          Your Name    :  ______________________________________ (required!)
  1447.  
  1448.          Company      :  __________________________________________________
  1449.  
  1450.          Sysop Name   :  ______________________________________ (required!)
  1451.  
  1452.          BBS name     :  ______________________________________ (required!)
  1453.  
  1454.          Address      :  __________________________________________________
  1455.  
  1456.                          __________________________________________________
  1457.  
  1458.                          __________________________________________________
  1459.  
  1460.          Voice Phone# :  __________________________________________________
  1461.  
  1462.          BBS Phone#   :  __________________________________________________
  1463.  
  1464.          Your FidoNet addresss (if applicable):  __________________________
  1465.  
  1466.          Type of registration: ( ) Personal         ( ) With printed manual
  1467.                                ( ) Commercial       ( ) On disk
  1468.  
  1469.          Payment method      : ( ) Check/Cash       ( ) VISA
  1470.                                ( ) Bank Transfer    ( ) Mastercard/Eurocard
  1471.  
  1472.          Amount       : ______________ (in registration site's currency!!)
  1473.  
  1474.  
  1475.          Credit Card #: _______________________________   Expires: ___/___
  1476.  
  1477.          Name on card : _______________________________
  1478.  
  1479.          Signature    : _______________________________
  1480.  
  1481.  
  1482.          Your key file will be sent to you via FidoNet netmail or you can
  1483.          download it from the registration site's BBS.  We can also send it
  1484.          to you on a diskette, but this will delay your registration
  1485.          considerably (and it will cost you extra).
  1486.  
  1487.          Please select how you would like to receive your key below:
  1488.  
  1489.          ( ) Netmail                     ( ) 3"1/2 Diskette (extra cost)
  1490.          ( ) Download from our BBS       ( ) 5"1/4 Diskette (extra cost)
  1491.  
  1492.  
  1493.  
  1494.                                       - 26 -
  1495.  
  1496.  
  1497.  
  1498.          ╔═════════════════════════════════════════════════════════════════╗
  1499.          ╟─── INSTALLATION ────────────────────────────────────────────────╢
  1500.          ╚═════════════════════════════════════════════════════════════════╝
  1501.  
  1502.  
  1503.          See the file INSTALL.TXT for installation instructions.
  1504.  
  1505.          If you currently operate a RemoteAccess bulletin board system,
  1506.          read the next paragraph for specific instructions on how to
  1507.          convert your existing system.
  1508.  
  1509.  
  1510.  
  1511.          ┌─────────────────────────────────────────────────────────────────┐
  1512.          │ RemoteAccess 2.02 to ProBoard Conversion                        │
  1513.          └─────────────────────────────────────────────────────────────────┘
  1514.  
  1515.          If you are operating a RemoteAccess 2.02 BBS system, you can
  1516.          convert your existing userfile, message files, message areas,
  1517.          file areas and menus to the format used by ProBoard.  This is done
  1518.          by running your RAFILE EXPORT in your RA system directory, and
  1519.          then running CONVERT.EXE in the ProBoard system directory.
  1520.  
  1521.          But, before you do ANYTHING, we highly recommend that you back up
  1522.          at least your existing RA files, if not your entire system.
  1523.  
  1524.          Here's the procedure to follow:
  1525.          ───────────────────────────────
  1526.  
  1527.          - Backup your existing files.
  1528.          - Install ProBoard as explained in the installation instructions.
  1529.          - Change to the RA system directory
  1530.          - Run RAFILE EXPORT
  1531.              (Note: for areas where the FILES.BBS cannot be created in the
  1532.                     file area's directory, like for CD-ROM areas, you have
  1533.                     to run "RAFILE EXPORT" for each area separately.  See
  1534.                     your RA documentation for details)
  1535.          - Change to the ProBoard system directory (usually C:\PB).
  1536.          - Copy the following files from your RA message base directory to
  1537.            the ProBoard message base directory: USERS.BBS, USERSXI.BBS,
  1538.            LASTREAD.BBS, MSGINFO.BBS, MSGHDR.BBS, MSGTXT.BBS, MSGIDX.BBS,
  1539.            MSGTOIDX.BBS.
  1540.          - Run CONVERT RA <ra-dir>
  1541.              eg. CONVERT RA C:\RA
  1542.          - Run PBUTIL with the UF parameter.
  1543.              eg. PBUTIL UF
  1544.          - Run PBUTIL with the UP parameter.
  1545.              eg. PBUTIL UP
  1546.  
  1547.  
  1548.  
  1549.  
  1550.                                       - 27 -
  1551.  
  1552.  
  1553.  
  1554.          Things you will have to do manually:
  1555.              - Enter all system parameters in ProCFG (like paths).
  1556.              - Enter the user levels & download limits in ProCFG
  1557.              - Enter any events you have in PROCFG.
  1558.              - Copy any .Q-A files to the ProBoard directory.
  1559.  
  1560.  
  1561.  
  1562.          ┌─────────────────────────────────────────────────────────────────┐
  1563.          │ RemoteAccess Compatible Files                                   │
  1564.          └─────────────────────────────────────────────────────────────────┘
  1565.  
  1566.          ProBoard uses different files than RA to store the file area and
  1567.          message area configurations.  Therefore, to run any of your RA
  1568.          utilities that use the files CONFIG.RA, FILES.RA or MESSAGES.RA
  1569.          you must first run a conversion program to create compatible
  1570.          versions of these files.  Which conversion you need to run depends
  1571.          on which version of RA the utility you want to run was written for.
  1572.  
  1573.          Use the CONVERT utility (Supplied with PB_215.ZIP) to create the
  1574.          following files from your ProBoard system files.
  1575.  
  1576.              FILES.RA
  1577.              MESSAGES.RA
  1578.              CONFIG.RA
  1579.  
  1580.          If the utility you want to run was written for RA v1.1x then you
  1581.          need to run "CONVERT SIMUL1".  If the utility you want to run was
  1582.          written for RA v2.xx then you need to run "CONVERT SIMUL2".
  1583.  
  1584.          The CONVERT SIMUL<x> routine will place these files in the
  1585.          directory where you run CONVERT SIMUL<x> from.  We strongly suggest
  1586.          running it from your ProBoard system directory (usually C:\PB).
  1587.  
  1588.          You must run this conversion before you attempt to use your
  1589.          favorite RA utilities.  Since it is possible for the wrong version
  1590.          of the files CONVERT SIMUL<x> creates to be present from an earlier
  1591.          conversion we suggest running CONVERT SIMUL<x> from a batch file
  1592.          each time you call a utility that needs these files.  An example
  1593.          is as follows:
  1594.  
  1595.          CONVERT SIMUL2
  1596.          run RA 2.xx utility here...
  1597.  
  1598.          later...
  1599.  
  1600.          CONVERT SIMUL1
  1601.          run RA 1.1x utility here...
  1602.  
  1603.  
  1604.  
  1605.  
  1606.                                       - 28 -
  1607.  
  1608.  
  1609.  
  1610.          You should run the correct "CONVERT SIMUL<x>" each time before you
  1611.          run one of your RA utilities.
  1612.  
  1613.          Option:
  1614.          ───────
  1615.          When running CONVERT SIMUL<x>, you can specify the "-U"
  1616.          parameter (CONVERT SIMUL<x> -U).  This will allow CONVERT to
  1617.          create up to 10,000 file areas in FILES.RA instead of the first
  1618.          200 only.
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.                                       - 29 -
  1663.  
  1664.  
  1665.  
  1666.          ╔═════════════════════════════════════════════════════════════════╗
  1667.          ╟─── STARTING PROBOARD ───────────────────────────────────────────╢
  1668.          ╚═════════════════════════════════════════════════════════════════╝
  1669.  
  1670.  
  1671.          ProBoard looks for its data files in the directory where
  1672.          PROBOARD.EXE is located.  You can, however, tell ProBoard to look
  1673.          for the data files in another directory by setting the environment
  1674.          variable PROBOARD (eg. SET PROBOARD=F:\PB).  The environment
  1675.          variable DSZLOG used by most protocols is not needed.  ProBoard
  1676.          will set this variable prior to starting the protocol.
  1677.  
  1678.          You should start ProBoard with a batch file.  ProBoard should
  1679.          ALWAYS be run with a batch file, because it returns to DOS when a
  1680.          user logs off.
  1681.  
  1682.          Below is a basic batch file for stand-alone operation (without a
  1683.          mailer).  It is called P.BAT and is included in PB_215.ZIP
  1684.  
  1685.            :again
  1686.                 PROBOARD -S
  1687.                 if errorlevel 99 goto out
  1688.                 if errorlevel 1 goto fatal
  1689.                 goto again
  1690.  
  1691.            :fatal
  1692.                 echo A fatal error occurred.
  1693.                 goto x
  1694.  
  1695.            :out
  1696.                 echo Normal exit.
  1697.  
  1698.            :x
  1699.  
  1700.  
  1701.          Note that errorlevels 2-4 generate a fatal error.  These error-
  1702.          levels are used for mail networking, and ProBoard should not
  1703.          return one of these errorlevels in a standalone environment.
  1704.  
  1705.          The PROBOARD.EXE command line options are discussed in the
  1706.          "Reference" chapter later in this manual.
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.                                       - 30 -
  1719.  
  1720.  
  1721.  
  1722.          ───────────────
  1723.          ** IMPORTANT **
  1724.          ───────────────
  1725.          In order for PROBOARD.EXE to function properly, it's DOS file
  1726.          attribute MUST be set to "read-only".  This is done using the DOS
  1727.          ATTRIB command.
  1728.  
  1729.          Example:
  1730.          ────────
  1731.          ATTRIB +R  PROBOARD.EXE  (this marks PROBOARD.EXE as "read only")
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.                                       - 31 -
  1775.  
  1776.  
  1777.  
  1778.          ╔═════════════════════════════════════════════════════════════════╗
  1779.          ╟─── CONFIGURATION ───────────────────────────────────────────────╢
  1780.          ╚═════════════════════════════════════════════════════════════════╝
  1781.  
  1782.  
  1783.          ProBoard is completely configured by PROCFG.EXE. This program can
  1784.          be executed from any directory as long as PROCFG.EXE is in your
  1785.          path.  In most of the menus, just press <Ins> to add an item,
  1786.          press <Del> to remove an item, and press <Enter> to select an
  1787.          item.
  1788.  
  1789.  
  1790.  
  1791.          ┌─────────────────────────────────────────────────────────────────┐
  1792.          │ Options (F1)                                                    │
  1793.          └─────────────────────────────────────────────────────────────────┘
  1794.  
  1795.          This is the first option to choose when running PROCFG.EXE. A
  1796.          second menu will be displayed with the following items:
  1797.  
  1798.             - Paths
  1799.             - New Users
  1800.             - Security
  1801.             - Yelling
  1802.             - System Options
  1803.             - File Transfer
  1804.             - Display Options
  1805.             - Site Info
  1806.             - QWK Options
  1807.             - File List Format
  1808.  
  1809.          A description of these fields follows.
  1810.  
  1811.  
  1812.  
  1813.          ┌─────────────────────────────────────────────────────────────────┐
  1814.          │ Paths                                                           │
  1815.          └─────────────────────────────────────────────────────────────────┘
  1816.  
  1817.          Text Files .................. Directory where ProBoard's textfiles
  1818.                                        are stored (drive included!).
  1819.  
  1820.          RIP Files ................... Directory where ProBoard's RIP files
  1821.                                        are stored (drive included!).
  1822.  
  1823.          RIP Icons ................... Directory where ProBoard's RIP icons
  1824.                                        are stored (drive included!).
  1825.  
  1826.          Menus ....................... Directory where ProBoard's menus are
  1827.                                        stored (drive included!).
  1828.  
  1829.  
  1830.                                       - 32 -
  1831.  
  1832.  
  1833.  
  1834.          Message Base ................ Directory where the message base
  1835.                                        will be stored (drive included!).
  1836.  
  1837.          Uploads ..................... Directory where the users' uploads
  1838.                                        will be stored (drive included!).
  1839.  
  1840.          Private Uploads ............. Directory where personal files
  1841.                                        are stored. (for file exchanges
  1842.                                        between users).
  1843.  
  1844.          Nodelist Directory .......... Directory where the nodelist is
  1845.                                        located. For use by the nodelist
  1846.                                        compiler. Leave this field blank
  1847.                                        if you do not have a nodelist.
  1848.  
  1849.          PEX Files ................... Directory where the PEX files will
  1850.                                        be stored.
  1851.  
  1852.          Editor Command .............. The external editor's filename and
  1853.                                        path (eg. C:\GEDIT\GEDIT.EXE).  You
  1854.                                        can also specify a PEX file here by
  1855.                                        using a "@"as the first character.
  1856.  
  1857.                                        You can also use shell options here.
  1858.  
  1859.                                        It appears that if you are using
  1860.                                        GEdit v2.00 or v2.01 that you will
  1861.                                        need to write an RA 1.1x style
  1862.                                        EXITINFO.BBS file to make GEdit work
  1863.                                        with ProBoard 2.15.  This is done
  1864.                                        with the Menu Function 7 "*E"
  1865.                                        parameter.  Refer to Menu Function 7
  1866.                                        for more info.
  1867.  
  1868.                                        Example: *SGEDIT\GEDIT.EXE -N*#*E
  1869.                                        Example: @MYEDIT  (for a PEX file).
  1870.  
  1871.                                        If you are not using an external
  1872.                                        editor, leave this field blank and
  1873.                                        ProBoard will default to it's
  1874.                                        internal line editor (you can also
  1875.                                        use ProBoard's internal fullscreen
  1876.                                        editor by enabling the next option).
  1877.  
  1878.                                        NOTE: this command will be ignored
  1879.                                        if ProBoard's internal fullscreen
  1880.                                        editor is enabled with the next
  1881.                                        option.
  1882.  
  1883.  
  1884.  
  1885.  
  1886.                                       - 33 -
  1887.  
  1888.  
  1889.  
  1890.          Use internal fullscreen ..... Set this to "Yes" to enable the
  1891.          editor                        built-in fullscreen editor instead
  1892.                                        of the external editor defined in
  1893.                                        "Editor Command".  When the internal
  1894.                                        fullscreen editor is enabled, the
  1895.                                        external editor will be ignored.
  1896.  
  1897.  
  1898.          External Chat ............... Path to your external chat program.
  1899.                                        If one is defined here it will be
  1900.                                        executed instead of ProBoard's
  1901.                                        internal chat routine.  You can
  1902.                                        specify either a  chat door (.EXE)
  1903.                                        or a chat PEX (.PEX) file here.
  1904.  
  1905.                                        If you want to specify an .EXE file,
  1906.                                        enter the full path to the program.
  1907.                                        (see example below).
  1908.  
  1909.                                        If you want to specify a PEX file,
  1910.                                        you must place a "@" character
  1911.                                        before the command line.
  1912.                                        (see example below).
  1913.  
  1914.                                        You can also use the "Shell" (Menu
  1915.                                        Function 7) parameters (like *X
  1916.                                        etc.) or the text macros (@<...>@).
  1917.  
  1918.                                        To use the built-in chat routine in
  1919.                                        ProBoard, leave this line blank.
  1920.  
  1921.  
  1922.                                      Examples:
  1923.                                      ─────────
  1924.  
  1925.                                      *E*SGCHAT.EXE D E    (.EXE chat door)
  1926.                                       @TheChat            (.PEX chat door)
  1927.  
  1928.  
  1929.  
  1930.          ┌─────────────────────────────────────────────────────────────────┐
  1931.          │ New Users                                                       │
  1932.          └─────────────────────────────────────────────────────────────────┘
  1933.  
  1934.          New User Level .............. The level a user will have upon his
  1935.                                        or her first login.
  1936.  
  1937.          New User Flags .............. The flags a user will have upon his
  1938.                                        or her first login.
  1939.  
  1940.  
  1941.  
  1942.                                       - 34 -
  1943.  
  1944.  
  1945.  
  1946.          New User Loglevel ........... The loglevel a user will have upon
  1947.                                        his or her first login.  This
  1948.                                        controls what information about the
  1949.                                        users session will be written to the
  1950.                                        system log (more info about this
  1951.                                        in the chapter titled USERS).
  1952.  
  1953.          Allow ANSI .................. Allows New Users to select ANSI
  1954.                                        terminal emulation.
  1955.  
  1956.          Allow AVATAR ................ Allow new users to select either
  1957.                                        AVATAR/0 or AVATAR/0+ terminal
  1958.                                        emulation.
  1959.  
  1960.          Ask Voice Phone ............. Determines whether ProBoard should
  1961.                                        ask for a user's voice phone number
  1962.                                        at the time of their first login.
  1963.  
  1964.          Ask Data Phone .............. Determines if ProBoard should ask
  1965.                                        for a users data phone number at
  1966.                                        the time of their first login.
  1967.  
  1968.          Ask FAX Phone ............... Determines if ProBoard should ask
  1969.                                        for a users FAX phone number at
  1970.                                        the time of their first login.
  1971.  
  1972.          Ask Birth Date .............. Determines if ProBoard should ask a
  1973.                                        new user for their birth date.
  1974.                                        If this is set to "Allow Blank" then
  1975.                                        users can decide whether they want
  1976.                                        to leave the birth date field empty
  1977.                                        or provide it for their user record.
  1978.  
  1979.          Ask State ................... Determines whether ProBoard should
  1980.                                        ask the user for the State that they
  1981.                                        live in.
  1982.  
  1983.          Ask Country ................. Determines if ProBoard should ask
  1984.                                        users for the Country they live in.
  1985.  
  1986.          Ask Address ................. Determines if ProBoard will ask
  1987.                                        users for their address.  If this
  1988.                                        is set to "Yes" ProBoard will
  1989.                                        present the user with 3 lines to
  1990.                                        enter their address.
  1991.  
  1992.          Ask Sex ..................... If this is set to "Yes" ProBoard
  1993.                                        will ask the user if they are male
  1994.                                        or female.
  1995.  
  1996.  
  1997.  
  1998.                                       - 35 -
  1999.  
  2000.  
  2001.  
  2002.          Ask Date Format ............. If set to "Yes" ProBoard will
  2003.                                        allow the user to select the date
  2004.                                        format they prefer.  Choices are:
  2005.  
  2006.                                                 MM/DD/YY
  2007.                                                 YY/MM/DD
  2008.                                                 DD/MM/YY
  2009.  
  2010.  
  2011.  
  2012.          ┌─────────────────────────────────────────────────────────────────┐
  2013.          │ Security                                                        │
  2014.          └─────────────────────────────────────────────────────────────────┘
  2015.  
  2016.          Allow Quick Login ........... If this is enabled, the SysOp can
  2017.                                        login locally by pressing [Enter] at
  2018.                                        the login prompt without entering a
  2019.                                        password. If you don't like this,
  2020.                                        just turn it off.
  2021.  
  2022.          Write Pwd-Failure Messages .. If a user fails to log in because
  2023.                                        he/she exceeded the maximum number
  2024.                                        of password retries, ProBoard can
  2025.                                        write a security message to that
  2026.                                        person and to the SysOp, telling
  2027.                                        him/her what happened. This can be
  2028.                                        turned on or off with this option.
  2029.  
  2030.          Allow Login With Alias ...... Determines if ProBoard will allow
  2031.                                        users to login with their alias
  2032.                                        (handle).  Users can also select or
  2033.                                        change their alias using Menu
  2034.                                        Function 59.  If this option is set
  2035.                                        to "No", ProBoard will not ask new
  2036.                                        users to select an alias.
  2037.  
  2038.          Log Local Calls ............. If this option is enabled, all local
  2039.                                        logins will be logged in the file
  2040.                                        PROBOARD.LOG (ProBoard's system log).
  2041.  
  2042.          Hide SysOp Activity ......... If enabled, ProBoard will hide all
  2043.                                        SysOp activity from the Last Callers
  2044.                                        list (Function 51), Show Users Online
  2045.                                        (Function 50), and from the display
  2046.                                        of the User List (Function 13).
  2047.  
  2048.          Max. Password Retries ....... Maximum number of incorrect password
  2049.                                        attempts ProBoard will allow, before
  2050.                                        logging the user off.
  2051.  
  2052.  
  2053.  
  2054.                                       - 36 -
  2055.  
  2056.  
  2057.  
  2058.          Min. Password Length ........ The minimum length of a password.
  2059.                                        Should you change this option at a
  2060.                                        later time to less than the length
  2061.                                        of any existing users passwords,
  2062.                                        ProBoard will not check for Minimum
  2063.                                        Password Length when an existing
  2064.                                        user logs on.  ProBoard will
  2065.                                        however enforce this setting again
  2066.                                        when any existing users decide to
  2067.                                        change their password.
  2068.  
  2069.          Security Message Area ....... The message area number where
  2070.                                        ProBoard's Security Manager should
  2071.                                        write it's security related messages.
  2072.  
  2073.          Level For Crashmail ......... Level needed to send crash mail.
  2074.  
  2075.          Flags For Crashmail ......... Flags needed to send crash mail.
  2076.  
  2077.          Level For Fileattach ........ Level needed to do a file attach
  2078.                                        for Netmail.
  2079.  
  2080.          Flags For Fileattach ........ Flags needed to do a file attach
  2081.                                        for Netmail.
  2082.  
  2083.          Use System Password ......... (Yes/No). If set to "Yes", ProBoard
  2084.                                        will require all incoming callers to
  2085.                                        know and enter a 'System Password'
  2086.                                        before asking them for their user
  2087.                                        name and user password.  Great for
  2088.                                        running a 'Private' BBS in a
  2089.                                        corporation, etc.  If set to "No"
  2090.                                        users will not be prompted for a
  2091.                                        'System Password'.
  2092.  
  2093.          System Password ............  If the above option 'Use System
  2094.                                        Password' is set to 'Yes', this is
  2095.                                        the password users are required to
  2096.                                        enter to gain access to the BBS.
  2097.  
  2098.  
  2099.  
  2100.          ┌─────────────────────────────────────────────────────────────────┐
  2101.          │ Yelling                                                         │
  2102.          └─────────────────────────────────────────────────────────────────┘
  2103.  
  2104.          Max. SysOp Pages ............ Number of times a user can page the
  2105.                                        SysOp during one session.
  2106.  
  2107.  
  2108.  
  2109.  
  2110.                                       - 37 -
  2111.  
  2112.  
  2113.  
  2114.          PageBell Length ............. Number of seconds the SysOp paging
  2115.                                        bell will ring.
  2116.  
  2117.          Paging Hours ................ Pressing <ENTER> on this option
  2118.                                        opens a window which allows you to
  2119.                                        specify during what hours a user can
  2120.                                        page you.  Hours are selectable for
  2121.                                        each day of the week, in half hour
  2122.                                        increments.
  2123.  
  2124.          Message Area # .............. When a user pages you and you don't
  2125.                                        respond, they will be asked if they
  2126.                                        want to leave you a message.
  2127.                                        If they choose to do so, the message
  2128.                                        area number you define here will be
  2129.                                        where their message to you is
  2130.                                        placed.
  2131.  
  2132.  
  2133.  
  2134.          ┌─────────────────────────────────────────────────────────────────┐
  2135.          │ System Options                                                  │
  2136.          └─────────────────────────────────────────────────────────────────┘
  2137.  
  2138.          Check Mail At Login ......... Determines whether ProBoard should
  2139.                                        check for new mail and files upon
  2140.                                        login. If set to "Ask", ProBoard
  2141.                                        will ask the user if they want to
  2142.                                        check for waiting mail/personal
  2143.                                        files.
  2144.  
  2145.          Allow One-Word Names ........ Determines whether a user's name can
  2146.                                        be a single word.
  2147.  
  2148.          Date Format ................. Determines if ProBoard should display
  2149.                                        all dates in European format
  2150.                                        (DD/MM/YY) or American format
  2151.                                        (MM/DD/YY).
  2152.  
  2153.          Use File Sharing ............ Set this option to "Yes", if you
  2154.                                        want to share the message base with
  2155.                                        FrontDoor or any other utility that
  2156.                                        uses the same locking scheme as
  2157.                                        RemoteAccess/FrontDoor
  2158.  
  2159.          Swap to Disk ................ Determines the default shelling
  2160.                                        mode. If this option is set to ON,
  2161.                                        ProBoard will be swapped to
  2162.                                        disk/EMS, leaving only 2000 bytes
  2163.                                        resident!
  2164.  
  2165.  
  2166.                                       - 38 -
  2167.  
  2168.  
  2169.  
  2170.          Fast Mode ................... When this option is enabled,
  2171.                                        ProBoard will use about 10Kb more
  2172.                                        memory (depending on the number
  2173.                                        of file-areas), but the system
  2174.                                        will run faster.
  2175.  
  2176.          Kill Netmail When Sent ...... Controls whether netmail will be
  2177.                                        killed after a message has been
  2178.                                        exported from the message base.
  2179.  
  2180.          Confirm Validate ............ If this is set to "Yes", ProBoard
  2181.                                        will prompt you to confirm any
  2182.                                        validation on a user record when
  2183.                                        applying a validation template.
  2184.                                        If set to "No", no confirmation
  2185.                                        will be required once a validation
  2186.                                        template is selected to be applied
  2187.                                        to a user record.
  2188.  
  2189.          Activity Log Size ........... ProBoard creates and maintains a
  2190.                                        file called BINLOG.PB in your
  2191.                                        ProBoard System Directory.  This
  2192.                                        file contains information for
  2193.                                        generation of system graphs etc.
  2194.                                        Set the number of days worth of
  2195.                                        data the file BINLOG.PB should
  2196.                                        contain.  Entering a 0 (zero)
  2197.                                        means the BINLOG.PB file will
  2198.                                        grow forever.
  2199.  
  2200.          Log Local Activity .......... If set to "Yes", ProBoard will add
  2201.                                        your local login activity to the
  2202.                                        BINLOG.PB file.
  2203.  
  2204.          I/O Buffer Size ............. Specifies the amount (in bytes) that
  2205.                                        ProBoard will use for it's internal
  2206.                                        serial communication buffering.
  2207.                                        Recommended buffer size is 32 for
  2208.                                        single line systems.  If you are
  2209.                                        running a multi-node system under
  2210.                                        a multi-tasker such as DESQview,
  2211.                                        OS/2, or Windows, you probably will
  2212.                                        want to increase this value.  To
  2213.                                        disable I/O buffering completely set
  2214.                                        this field to the value of 1.
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.                                       - 39 -
  2223.  
  2224.  
  2225.  
  2226.          Default language file ....... Name of the language file to be
  2227.                                        loaded when ProBoard starts.  This
  2228.                                        language will also be loaded when a
  2229.                                        user logs in who's language could
  2230.                                        not be found.
  2231.  
  2232.          Inactivity Limit ............ Number of seconds a user is allowed
  2233.                                        to remain idle.  If the user hasn't
  2234.                                        typed anything when this limit is
  2235.                                        exceeded, they will be logged off.
  2236.  
  2237.          Quote String ................ This string is used to when ProBoard
  2238.                                        quotes a message for a reply.
  2239.                                        A '@' character is replaced by the
  2240.                                        initials of the user who wrote the
  2241.                                        message quoted from.
  2242.  
  2243.          Password Display ............ Enter the character that you want
  2244.                                        ProBoard to display to users, as
  2245.                                        they enter their password.  The
  2246.                                        character you enter here will also
  2247.                                        be used in place of displaying the
  2248.                                        password if you have "Hide
  2249.                                        Password" (below) set to "Yes".  You
  2250.                                        may use any ASCII character (1-255)
  2251.                                        as a Password Display character.
  2252.  
  2253.          Hide Password ............... If this option is set to yes, when
  2254.                                        you bring up user records in the
  2255.                                        User Editor, the users password will
  2256.                                        not be displayed.  Instead, the
  2257.                                        character you entered in "Password
  2258.                                        Display" (above) will be shown.
  2259.                                        If this option is set to "No" then
  2260.                                        you will see each users password when
  2261.                                        using the User Editor.
  2262.  
  2263.          Screen Blanking ............. Enter the number of seconds that
  2264.                                        should elapse before ProBoard's
  2265.                                        built-in screen saver should blank
  2266.                                        your screen.
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.                                       - 40 -
  2279.  
  2280.  
  2281.  
  2282.          Fuzzy Search Rate ........... Determines how extensive ProBoard's
  2283.                                        fuzzy search feature should work.
  2284.                                        The fuzzy search will help your
  2285.                                        users locate other users from your
  2286.                                        user file when posting messages and
  2287.                                        a misspelled name is encountered.
  2288.                                        It is also used in the User Editor
  2289.                                        when you perform searches.  The
  2290.                                        higher the value you enter here, the
  2291.                                        closer a user record must match the
  2292.                                        search criteria before it is
  2293.                                        considered a find by the fuzzy search
  2294.                                        engine.
  2295.  
  2296.          RIP Graphics ................ Determines if ProBoard will display
  2297.                                        RIP Graphics (both internal and user
  2298.                                        created) to the user or not.  If set
  2299.                                        to "Disabled" (use the space bar to
  2300.                                        toggle the setting) RIP Graphics will
  2301.                                        not be displayed to the user even if
  2302.                                        RIP is detected when the user logs
  2303.                                        in.
  2304.  
  2305.  
  2306.  
  2307.          ┌─────────────────────────────────────────────────────────────────┐
  2308.          │ File Transfer                                                   │
  2309.          └─────────────────────────────────────────────────────────────────┘
  2310.  
  2311.          Minimum Upload Space ........ Space needed on the upload drive for
  2312.                                        uploads to be allowed (in Kb).
  2313.  
  2314.          Download Hours .............. Pressing <ENTER> on this option
  2315.                                        opens a window which allows you to
  2316.                                        specify during what hours a user can
  2317.                                        download files from your system.
  2318.                                        Hours are selectable for each day of
  2319.                                        the week, in half hour increments.
  2320.                                        The value of the "Ignore DL" flag in
  2321.                                        the user's record will override any
  2322.                                        hours you may have set here.
  2323.  
  2324.  
  2325.  
  2326.  
  2327.  
  2328.  
  2329.  
  2330.  
  2331.  
  2332.  
  2333.  
  2334.                                       - 41 -
  2335.  
  2336.  
  2337.  
  2338.          Check Duplicate Uploads ..... If this option is set to "Yes",
  2339.                                        ProBoard's Menu Function 33
  2340.                                        (Upload a File) will check upon
  2341.                                        completion of any upload(s) for
  2342.                                        duplicate files.  ProBoard can not
  2343.                                        check for duplicates prior to any
  2344.                                        upload(s) due to any batch protocols
  2345.                                        the user may choose to use.
  2346.                                        Use this option along with
  2347.                                        the next two options (below) to
  2348.                                        decide how you want your system to
  2349.                                        deal with any duplicate files your
  2350.                                        users may upload.
  2351.  
  2352.          Kill Duplicate Uploads ...... If set to "Yes", when a user uploads
  2353.                                        a file that already exists on your
  2354.                                        system (in the file index) then
  2355.                                        ProBoard will delete the file from
  2356.                                        your upload directory (as specified
  2357.                                        in the data line of your upload menu
  2358.                                        entry or in PROCFG).  If you want to
  2359.                                        save the duplicate files rather than
  2360.                                        have them deleted, set this option
  2361.                                        to "No".  When does ProBoard delete
  2362.                                        the file?  Great question!!
  2363.  
  2364.                                        ProBoard will delete any duplicate
  2365.                                        files immediately after checking for
  2366.                                        dupes, even before the user is
  2367.                                        prompted to enter a file description,
  2368.                                        so think twice before you set this
  2369.                                        option to "Yes".
  2370.  
  2371.                                        You can also create a text file to
  2372.                                        be displayed to your users in the
  2373.                                        event that they do upload duplicate
  2374.                                        files.  The file that ProBoard will
  2375.                                        display must be named DUPESFND.A??
  2376.                                        and be placed in your "Textfiles"
  2377.                                        directory (usually C:\PB\TXTFILES).
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.  
  2386.  
  2387.  
  2388.  
  2389.  
  2390.                                       - 42 -
  2391.  
  2392.  
  2393.  
  2394.          Ignore File Extensions ...... If this option is set to "Yes", then
  2395.                                        ProBoard's duplicate checking will
  2396.                                        consider NEWFILE.ZIP and NEWFILE.ARJ
  2397.                                        to be the same file.  So if you have
  2398.                                        NEWFILE.ZIP on your hard drive or
  2399.                                        CD-ROM drive and a user uploads
  2400.                                        NEWFILE.ARJ, ProBoard will consider
  2401.                                        this to be a duplicate upload.
  2402.  
  2403.                                        Be sure you understand this before
  2404.                                        setting this option to "Yes".
  2405.  
  2406.          Upload scanner .............. When uploads are received, ProBoard
  2407.                                        will run the command line specified
  2408.                                        here FOR EACH FILE.  The macro
  2409.                                        @<FILE>@ will be replaced by the
  2410.                                        full name of the file to be scanned
  2411.                                        (including drive and directory).
  2412.                                        When the file is suspicious, the
  2413.                                        upload scanner should do one of 2
  2414.                                        things:
  2415.  
  2416.                                        - Return with an errorlevel
  2417.                                          different from 0.
  2418.                                        - Create a semaphore file with a
  2419.                                          name specified in "Semaphore".
  2420.  
  2421.                                       If the file failed the virus scan (so
  2422.                                       if a semaphore file was created or an
  2423.                                       errorlevel was returned), ProBoard
  2424.                                       will perform an action on the file
  2425.                                       (defined in "action")
  2426.  
  2427.                                       - None  : No action (but upload is
  2428.                                                 not credited to the user's
  2429.                                                 account)
  2430.  
  2431.                                       - Move  : The file is moved to a
  2432.                                                 different area (specified
  2433.                                                 in "bad file area")
  2434.  
  2435.                                       - Delete: The file is deleted
  2436.  
  2437.                                       If you don't want to use the upload
  2438.                                       scanner, just leave the command line
  2439.                                       for the upload scanner blank.
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.                                       - 43 -
  2447.  
  2448.  
  2449.  
  2450.          Add Uploaders Name
  2451.          to FILES.BBS ................ If set to "Yes" the uploaders name
  2452.                                        will be added to the file name and
  2453.                                        description in FILES.BBS.
  2454.  
  2455.  
  2456.  
  2457.          ┌─────────────────────────────────────────────────────────────────┐
  2458.          │ Display Options                                                 │
  2459.          └─────────────────────────────────────────────────────────────────┘
  2460.  
  2461.          Use 43/50 Line Mode ......... Enable local display of ProBoard in
  2462.                                        43 or 50 line mode.
  2463.  
  2464.          Show User Info Window ....... Should ProBoard display the User
  2465.                                        Info Window, when users are online.
  2466.  
  2467.  
  2468.  
  2469.          ┌─────────────────────────────────────────────────────────────────┐
  2470.          │ Site Info                                                       │
  2471.          └─────────────────────────────────────────────────────────────────┘
  2472.  
  2473.          System Name ................. The name of your BBS.  Will be
  2474.                                        written to EXITINFO.BBS.  Be sure
  2475.                                        this matches any "keys" you might
  2476.                                        have for any door programs.
  2477.                                        This information is also used for
  2478.                                        your key file when you register,
  2479.                                        so be sure whatever you put here
  2480.                                        matches what you fill out on your
  2481.                                        registration form EXACTLY!
  2482.  
  2483.          Location .................... The City where your BBS is located.
  2484.                                        This is used for the QWK packets
  2485.                                        created by your BBS so it's a good
  2486.                                        idea not to leave it blank when you
  2487.                                        set up your BBS.
  2488.  
  2489.          Phone Number ................ The primary phone number of your
  2490.                                        BBS.  Also used for QWK packets so
  2491.                                        be sure to not leave this field
  2492.                                        empty.
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.                                       - 44 -
  2503.  
  2504.  
  2505.  
  2506.          SysOp Name .................. The name of the SysOp.  This also
  2507.                                        will be written to EXITINFO.BBS
  2508.                                        This information is also used for
  2509.                                        your key file when you register,
  2510.                                        so be sure whatever you put here
  2511.                                        matches what you fill out on your
  2512.                                        registration form EXACTLY!
  2513.  
  2514.          Default Origin Line ......... Default origin line, used for
  2515.                                        Echomail if none is specified
  2516.                                        when setting up your echomail
  2517.                                        areas. (more about this later).
  2518.  
  2519.          Number of Nodes ............. Used for multi-line systems.  Enter
  2520.                                        the maximum number of users allowed
  2521.                                        to log in at the same time (max. 255)
  2522.  
  2523.  
  2524.  
  2525.          ┌─────────────────────────────────────────────────────────────────┐
  2526.          │ QWK Options                                                     │
  2527.          └─────────────────────────────────────────────────────────────────┘
  2528.  
  2529.          QWK File Name ............... This is the name that QWK packets
  2530.                                        generated by ProBoard's QWK PEX
  2531.                                        will be given.
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.                                       - 45 -
  2559.  
  2560.  
  2561.  
  2562.          ┌─────────────────────────────────────────────────────────────────┐
  2563.          │ File List Format                                                │
  2564.          └─────────────────────────────────────────────────────────────────┘
  2565.  
  2566.          It is here in PROCFG that you define how you want your file
  2567.          listings displayed to your users.  Pressing <ENTER> on any of the
  2568.          following options (except for Hide/Show file counters which is an
  2569.          on/off toggle) will invoke ProBoard's color editing window, which
  2570.          will allow you to customize the colors of the items displayed in
  2571.          your file listings.  As you begin to define the colors for your
  2572.          file listings, and whether or not to display file counters,
  2573.          ProBoard shows you in the bottom window how your file listings
  2574.          will appear to your users.
  2575.  
  2576.          Hot Tip!
  2577.          ────────
  2578.          Remember, you can change the colors, and then if you decide you
  2579.          don't like the colors you have selected, you can return to the
  2580.          previous color configuration by selecting "Cancel Changes" when
  2581.          exiting from PROCFG.  Just be aware that any other changes you
  2582.          made while in PROCFG will also be lost if you select "Cancel
  2583.          Changes".
  2584.  
  2585.  
  2586.          A brief explanation of each field follows.
  2587.          ──────────────────────────────────────────
  2588.  
  2589.          File Tag .................... The letter to the left of the file
  2590.                                        name.  This letter is what the user
  2591.                                        will press to tag the file for
  2592.                                        download.
  2593.  
  2594.          File Name ................... The name of the file.
  2595.  
  2596.          File Size ................... The size of the file.
  2597.  
  2598.          File Date ................... The date of the file
  2599.  
  2600.          File Counter ................ How many times the file has been
  2601.                                        downloaded from your system.  (Refer
  2602.                                        to PBUTIL FC (File Counters) for
  2603.                                        more information on how the file
  2604.                                        counters are maintained).
  2605.  
  2606.          File Description ............ The description of the file.
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.                                       - 46 -
  2615.  
  2616.  
  2617.  
  2618.          Extended Descriptions and
  2619.          Separators .................. Any lines of text in your file
  2620.                                        listings beginning with a space, are
  2621.                                        considered to be extended
  2622.                                        descriptions (or comments).  This is
  2623.                                        not to be confused with extended
  2624.                                        file descriptions which begin with a
  2625.                                        "+" character, and may actually span
  2626.                                        several lines in your file listings.
  2627.  
  2628.          Missing Files ............... A file name which is in your file
  2629.                                        listing but the file does not
  2630.                                        physically exist on the hard drive
  2631.                                        or CD-ROM where you told ProBoard to
  2632.                                        find it.
  2633.  
  2634.          Hide/Show File Counter ...... Toggles the display of file counters
  2635.                                        on/off by pressing <ENTER> on this
  2636.                                        selection.
  2637.  
  2638.  
  2639.  
  2640.          ┌─────────────────────────────────────────────────────────────────┐
  2641.          │ Protocol Configuration - (F2)                                   │
  2642.          └─────────────────────────────────────────────────────────────────┘
  2643.  
  2644.          The second option in PROCFG.EXE is "Protocols".  You may want to
  2645.          skip this option when doing a first-time installation of ProBoard,
  2646.          as many protocol configurations are included in the file
  2647.          PROTOCOL.PRO (which can be found in the file EX_CFG.ZIP).  You
  2648.          should select each protocol listed and set 'Enabled' to 'No' (you
  2649.          won't lose the protocol configuration) unless you have the actual
  2650.          protocol file itself physically on your hard drive.  The protocols
  2651.          themselves are NOT included with ProBoard, but can be obtained
  2652.          from any ProBoard Support BBS, as well as many others.
  2653.  
  2654.          Downloading and uploading files has always been one of the most
  2655.          important activities of BBS's.  Most BBS programs have file
  2656.          transfer protocols pre-installed and do not allow additional
  2657.          protocols to be configured.  ProBoard's philosophy is entirely
  2658.          different: no protocols are actually embedded in the code, all
  2659.          protocols are external and are being called by ProBoard.
  2660.  
  2661.          As of yet, we don't know of any external protocol incompatible
  2662.          with ProBoard, Bimodem included!  If you happen to find one that
  2663.          you think is an incompatible external file transfer protocol,
  2664.          please let us know!
  2665.  
  2666.  
  2667.  
  2668.  
  2669.  
  2670.                                       - 47 -
  2671.  
  2672.  
  2673.  
  2674.          Upon selection of the 'Protocols' option, a submenu is displayed
  2675.          containing the protocols already present. Add a protocol by
  2676.          pressing <Ins>, remove a protocol by pressing <Del>.
  2677.  
  2678.  
  2679.          A protocol is entirely defined by the following parameters:
  2680.  
  2681.          Protocol Name ............... Protocol's name, to be displayed in
  2682.                                        the down/upload menu. This can
  2683.                                        include a short description if you
  2684.                                        like.
  2685.  
  2686.          Hotkey ...................... Key to be pressed by the user to
  2687.                                        activate the protocol.
  2688.  
  2689.          Batch ....................... Determines whether the protocol can
  2690.                                        handle batch-mode (whether it can
  2691.                                        handle multiple files). Xmodem for
  2692.                                        example can handle only one file at
  2693.                                        a time, while Zmodem can handle
  2694.                                        multiple files.
  2695.  
  2696.          Enabled ..................... ProBoard comes with several pre-
  2697.                                        configured protocols for which you
  2698.                                        may not have the necessary files.
  2699.                                        It would be useless to have these
  2700.                                        protocols displayed in the menu. You
  2701.                                        can prevent this by setting Enable
  2702.                                        to 'No', without having to lose the
  2703.                                        configuration for this protocol.
  2704.  
  2705.          Both-Way .................... Determines whether the protocol is a
  2706.                                        full-duplex protocol, i.e.. whether
  2707.                                        it can send and receive files at the
  2708.                                        same time. (eg. Bimodem)
  2709.  
  2710.          Bimodem ..................... The Bimodem protocol uses an odd
  2711.                                        format for its control file. Setting
  2712.                                        Bimodem to 'Yes' causes the control
  2713.                                        file to be written to disk in
  2714.                                        Bimodem-format.
  2715.  
  2716.  
  2717.  
  2718.  
  2719.  
  2720.  
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.                                       - 48 -
  2727.  
  2728.  
  2729.  
  2730.          Log File .................... Name of the log file created by the
  2731.                                        protocol. After the file transfer,
  2732.                                        the information needed to update the
  2733.                                        user-records will be obtained from
  2734.                                        this file by ProBoard. Most
  2735.                                        protocols write a file specified
  2736.                                        in the environment variable DSZLOG.
  2737.                                        ProBoard will set this variable to
  2738.                                        the right filename for you. ProBoard
  2739.                                        checks for the logfile in the
  2740.                                        directory where it was started from,
  2741.                                        so if some external protocol writes
  2742.                                        a different logfile than the one
  2743.                                        specified in the DSZLOG-variable,
  2744.                                        make sure it writes the file in the
  2745.                                        startup-directory!
  2746.  
  2747.          Control File ................ Protocols that can handle batch-mode
  2748.                                        usually allow parameters to be
  2749.                                        passed not only on the command line,
  2750.                                        but also (should the command line
  2751.                                        grow too long) by means of a control
  2752.                                        file. ProBoard must know of this
  2753.                                        file, to be able to pass the file-
  2754.                                        names to the protocol.
  2755.  
  2756.          Download Command ............ Command needed to start the protocol
  2757.                                        in download-mode. You may want to
  2758.                                        use the shell options of menu
  2759.                                        function 7 here.
  2760.                                        If the first character of this
  2761.                                        command is a '@', the named pex-file
  2762.                                        will be run. Note that no shell
  2763.                                        parameters (*x) are supported when
  2764.                                        calling a pex-file. You can use
  2765.                                        string macros though.
  2766.  
  2767.                                        IMPORTANT: The command should be in-
  2768.                                                   dependent of the path it
  2769.                                                   is called from.
  2770.  
  2771.                                        Batch-mode protocols also require a
  2772.                                        control file to be specified. Should
  2773.                                        you, anywhere in this field, fill in
  2774.                                        a '#', then this character will at
  2775.                                        run-time be replaced by the filename
  2776.                                        of the file to be sent (only for
  2777.                                        non-batch protocols).
  2778.  
  2779.  
  2780.  
  2781.  
  2782.                                       - 49 -
  2783.  
  2784.  
  2785.  
  2786.          Upload Command .............. Command needed to start the protocol
  2787.                                        in upload-mode. Here also, the
  2788.                                        command should be independent of the
  2789.                                        directory it is called from and a
  2790.                                        '#' will be replaced by the filename
  2791.                                        of the file to be received (for
  2792.                                        non-batch protocols), or by the
  2793.                                        directory where files should be
  2794.                                        received into (for batch-protocols).
  2795.                                        A '@' as the first character will
  2796.                                        execute a pex-file (see DL Command).
  2797.  
  2798.          Download String ............. Determines what should be written in
  2799.                                        the control file when downloading.
  2800.                                        A '#' character is replaced by the
  2801.                                        path and filename of the file to
  2802.                                        be sent to the user. Most often, a
  2803.                                        single '#' is the only character in
  2804.                                        this field. This works for most of
  2805.                                        the protocols.
  2806.  
  2807.                                        Example:
  2808.  
  2809.                                        In case a user wants to download 3
  2810.                                        files, entering 'Send #' in this
  2811.                                        field causes the following to be
  2812.                                        written in the control file:
  2813.  
  2814.                                            Send C:\PB\FILES\COMM\TM.ZIP
  2815.                                            Send C:\PB\FILES\COMM\TBILL.ZIP
  2816.                                            Send C:\PB\FILES\UTIL\SHEZ55.ZIP
  2817.  
  2818.                                        You can always take a look at the
  2819.                                        pre-configured protocols, to lighten
  2820.                                        things up for you.
  2821.  
  2822.          Upload String ............... <reserved for future use>
  2823.  
  2824.          Download Keyword ............ In order to allow ProBoard to update
  2825.                                        the user-records from the protocol's
  2826.                                        log file, a keyword must be
  2827.                                        specified to indicate a file has
  2828.                                        successfully been sent. If a protocol
  2829.                                        writes 'Sent <filename>' in the
  2830.                                        logfile, you should specify 'Sent'
  2831.                                        as the keyword. This keyword is CASE
  2832.                                        SENSITIVE!
  2833.  
  2834.          Upload Keyword .............. Same as the previous field, for
  2835.                                        uploads.
  2836.  
  2837.  
  2838.                                       - 50 -
  2839.  
  2840.  
  2841.  
  2842.          File Word Number............. This is the number of the sent file's
  2843.                                        filename, counting from the keyword,
  2844.                                        but NOT including the keyword. This
  2845.                                        is used for both uploads and
  2846.                                        downloads.
  2847.  
  2848.                                        Eg. Sent 12/05/90 12334 PB_215.ZIP
  2849.  
  2850.                                        In this case, you should enter '3'
  2851.                                        as the word number, because
  2852.                                        PB_215.ZIP is the third word counting
  2853.                                        from, but not including, the keyword
  2854.                                        ('Sent').
  2855.  
  2856.          Efficiency .................. A percentage that gives the
  2857.                                        throughput efficiency for this
  2858.                                        protocol. This value is used to
  2859.                                        estimate the time needed to perform
  2860.                                        a file transfer.
  2861.  
  2862.  
  2863.          Local Only .................. If set to "Yes", this protocol will
  2864.                                        only be available when logging in
  2865.                                        locally.
  2866.  
  2867.  
  2868.          CONCLUSION:
  2869.  
  2870.          Correctly installing the protocols may seem somewhat difficult at
  2871.          first, but you will soon get used to it. And don't forget that the
  2872.          most commonly used protocols are already pre-configured in
  2873.          ProBoard!
  2874.  
  2875.  
  2876.  
  2877.          ┌─────────────────────────────────────────────────────────────────┐
  2878.          │ The Local Protocol PEX                                          │
  2879.          └─────────────────────────────────────────────────────────────────┘
  2880.  
  2881.          Included with ProBoard is a PEX which allows you to perform local
  2882.          file transfer (to/from your own hard disk).  This PEX is called
  2883.          LOC_PROT.PEX and should be located in your ProBoard PEX directory.
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.                                       - 51 -
  2895.  
  2896.  
  2897.  
  2898.          The protocol is already configured in the PROTOCOL.PRO file that
  2899.          comes with ProBoard.  If you have upgraded from an earlier version
  2900.          of ProBoard, you can add the protocol manually.  This is how you
  2901.          should set it up:
  2902.  
  2903.          ==================================================================
  2904.          Protocol Name: Local Download Protocol
  2905.  
  2906.          Hotkey       : L
  2907.          Batch        : Yes                             Efficiency: 100  %
  2908.          Enabled      : Yes
  2909.          Both-way     : No                              Local only: Yes
  2910.          Bimodem      : No
  2911.          Log-file     : DSZLOG.TXT
  2912.          Control-file : DSZCTL.TXT
  2913.  
  2914.          Download cmd : @LOC_PROT D @@<STARTDIR>@DSZCTL.TXT
  2915.  
  2916.          Upload cmd   : @LOC_PROT U #
  2917.  
  2918.          Downl. string: #
  2919.          Upload string:
  2920.  
  2921.          Downl. keyw. : D
  2922.          Upload keyw. : U
  2923.  
  2924.          File word nr : 1
  2925.          ==================================================================
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.                                       - 52 -
  2951.  
  2952.  
  2953.  
  2954.          ┌─────────────────────────────────────────────────────────────────┐
  2955.          │ Message Areas - (F3)                                            │
  2956.          └─────────────────────────────────────────────────────────────────┘
  2957.  
  2958.          ProBoard is one of the only BBS packages that allows you to use
  2959.          more than one message base format to hold your messages.  You can
  2960.          use Hudson, Squish, JAM, or Fido (.MSG) or a combination of these
  2961.          at the same time!
  2962.  
  2963.          ProBoard's message base limits are as follows:
  2964.          ──────────────────────────────────────────────
  2965.  
  2966.          Message Type    Number of Message Areas    Maximum File Size
  2967.          ────────────    ───────────────────────    ────────────────────────
  2968.          Hudson          200                        16 Mb / 15000 messages
  2969.                                                     (all areas combined)
  2970.          Squish          10,000                     5400 msgs. per area.
  2971.          Fido *.MSG      10,000                     Unlimited (disk space
  2972.                                                     available).
  2973.          JAM             10,000                     Unlimited (disk space
  2974.                                                     available).
  2975.  
  2976.  
  2977.          Each message area in ProBoard has its own name and properties.
  2978.  
  2979.          For example, you could have a message area for public messages
  2980.          only, several message areas for Echomail, or an area where you
  2981.          create "Announcement" messages for your users.
  2982.  
  2983.          Selecting "Message Areas" from the Main Menu, gives you a list of
  2984.          the available areas (which may initially be empty if you are
  2985.          setting up your BBS for the first time.)
  2986.  
  2987.          To edit a Message Area, press <Enter>.  To add a Message Area,
  2988.          press <Insert>, or enter a number for the area you want to create.
  2989.  
  2990.          For example, entering the number 10000 will create message area
  2991.          10000.  Keep in mind that if you are using the HUDSON format for
  2992.          any of your message areas, that any areas specified to use the
  2993.          HUDSON format will have to be specified as areas 1 - 200.  This
  2994.          is a limit of the existing HUDSON message base format and is not
  2995.          a limit of ProBoard.
  2996.  
  2997.  
  2998.          A message area has the following fields:
  2999.          ────────────────────────────────────────
  3000.  
  3001.          Name ........................ Name of this message area.
  3002.  
  3003.  
  3004.  
  3005.  
  3006.                                       - 53 -
  3007.  
  3008.  
  3009.  
  3010.          Path ........................ The path where this Message Area is
  3011.                                        located.  This is used for SQUISH,
  3012.                                        JAM, and *.MSG, but NOT for Hudson.
  3013.  
  3014.          Message Kind ................ The kind of message. You can have:
  3015.  
  3016.                                        - Local .......... Local messages
  3017.                                        - EchoMail ....... Echomail
  3018.                                        - NetMail ........ Netmail
  3019.                                        - Pvt EchoMail ... Private Echomail
  3020.  
  3021.                                        One word about the difference
  3022.                                        between the "Echo" type and the "Pvt
  3023.                                        Echo" type: In "Echo" areas, it is
  3024.                                        not allowed to delete messages that
  3025.                                        have been exported by an echomail
  3026.                                        processor (as specified by the FTSC,
  3027.                                        the FidoNet Technical Standards
  3028.                                        Committee). In a "Pvt Echo" area,
  3029.                                        this restriction is not imposed.
  3030.  
  3031.  
  3032.  
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.  
  3050.  
  3051.  
  3052.  
  3053.  
  3054.  
  3055.  
  3056.  
  3057.  
  3058.  
  3059.  
  3060.  
  3061.  
  3062.                                       - 54 -
  3063.  
  3064.  
  3065.  
  3066.          Message Type ................ One of the following:
  3067.  
  3068.                                        - Private only .. Only private
  3069.                                                          messages allowed.
  3070.  
  3071.                                        - Pvt/Public .... Private or public
  3072.                                                          messages allowed.
  3073.  
  3074.                                        - Public only ... Only public
  3075.                                                          messages allowed.
  3076.  
  3077.                                        - To All ........ This message type
  3078.                                                          should be used in
  3079.                                                          a LOCAL message
  3080.                                                          area only.
  3081.  
  3082.                                        The "To All" message type is
  3083.                                        intended for a SysOp to leave
  3084.                                        messages to all users.  Any messages
  3085.                                        entered in this area will considered
  3086.                                        "To All" regardless of the whom the
  3087.                                        "To" is addressed to.  Messages
  3088.                                        entered in this area will be shown
  3089.                                        when ProBoard checks for waiting
  3090.                                        mail.  You may not want to allow
  3091.                                        users to reply to these messages
  3092.                                        since their replies will be sent to
  3093.                                        all users.  A better idea is to set
  3094.                                        the "Reply Area" to a different
  3095.                                        message area number if you decide to
  3096.                                        let users reply to your announcement
  3097.                                        messages.
  3098.  
  3099.  
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.  
  3112.  
  3113.  
  3114.  
  3115.  
  3116.  
  3117.  
  3118.                                       - 55 -
  3119.  
  3120.  
  3121.  
  3122.          Name Options ................ Determines which names can be used
  3123.                                        to write messages in this area. This
  3124.                                        can be:
  3125.  
  3126.                                        - Real Names Only:
  3127.                                             Obvious I guess
  3128.  
  3129.                                        - Free Alias
  3130.                                             The user can choose any alias
  3131.                                             he likes, as long as it's not
  3132.                                             used by another user.
  3133.  
  3134.                                        - Fixed Alias (or real name)
  3135.                                             The user can choose between his
  3136.                                             real name and his alias
  3137.  
  3138.                                        - Fixed Alias (enforced)
  3139.                                             The user can only use his alias
  3140.                                             to write a message
  3141.  
  3142.                                        It is recommended that areas where
  3143.                                        aliases are allowed, are made
  3144.                                        "Public Only".
  3145.  
  3146.          Message Base ................ The type of message base to use for
  3147.                                        this message area.  Valid choices
  3148.                                        are Hudson, Squish, JAM, and Fido
  3149.                                        (*.MSG).
  3150.  
  3151.                                        Use the <SpaceBar> to toggle between
  3152.                                        available choices.  Remember, if you
  3153.                                        select Hudson that this message
  3154.                                        area's number (see top bar of the
  3155.                                        window) should be message area 200
  3156.                                        or lower since Hudson only supports
  3157.                                        up to 200 message areas.
  3158.  
  3159.          Read Level .................. Security Level needed to read
  3160.                                        messages in this area.
  3161.  
  3162.          Read Flags .................. Flags needed to read messages in
  3163.                                        this area.  You can now specify
  3164.                                        flags that a user MUST NOT have in
  3165.                                        order to READ from this message area.
  3166.                                        These flags are shown in reverse.
  3167.                                        To set a reverse flag, press the
  3168.                                        flag letter twice (it will appear
  3169.                                        reversed).  To clear a reversed flag
  3170.                                        type the flag letter one more time.
  3171.  
  3172.  
  3173.  
  3174.                                       - 56 -
  3175.  
  3176.  
  3177.  
  3178.          Write Level ................. Security Level needed to write
  3179.                                        messages in this area.
  3180.  
  3181.          Write Flags ................. Flags needed to write messages in
  3182.                                        this area.  You can now specify
  3183.                                        flags that a user MUST NOT have in
  3184.                                        order to WRITE to this message area.
  3185.                                        These flags are shown in reverse.
  3186.                                        To set a reverse flag, press the
  3187.                                        flag letter twice (it will appear
  3188.                                        reversed).  To clear a reversed flag
  3189.                                        type the flag letter one more time.
  3190.  
  3191.          SysOp Level ................. Security Level needed to be allowed
  3192.                                        access to all functions in this
  3193.                                        message area.
  3194.  
  3195.          SysOp Flags ................. Flags needed to be allowed access
  3196.                                        to all functions in this message
  3197.                                        area.  You can now specify flags that
  3198.                                        the SysOp MUST NOT have in order to
  3199.                                        be allowed access to all functions
  3200.                                        in this this message area.
  3201.                                        These flags are shown in reverse.
  3202.                                        To set a reverse flag, press the
  3203.                                        flag letter twice (it will appear
  3204.                                        reversed).  To clear a reversed flag
  3205.                                        type the flag letter one more time.
  3206.  
  3207.          Origin Line ................. Only for Echomail: if you do not
  3208.                                        specify this, the default origin
  3209.                                        line will be used (refer to F1,
  3210.                                        Site Options, to specify your
  3211.                                        default origin line).
  3212.  
  3213.          Use AKA ..................... The network address for this area
  3214.                                        (for Echomail & Netmail only).
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.                                       - 57 -
  3231.  
  3232.  
  3233.  
  3234.          EchoMail Tag ................ This field is used by ProBoard to
  3235.                                        create a file called ECHOTOSS.LOG
  3236.                                        You should enter the Echomail Tag
  3237.                                        name for this message area (if this
  3238.                                        message area has the "Message Kind"
  3239.                                        field set to "EchoMail").
  3240.                                        When a user enters a message into
  3241.                                        this area the tag name you specify
  3242.                                        here will be written to the file
  3243.                                        ECHOTOSS.LOG in the ProBoard system
  3244.                                        directory, causing your mail tosser
  3245.                                        to scan for outbound mail in this
  3246.                                        message area upon the callers
  3247.                                        logoff.
  3248.  
  3249.          QWK Area Name ............... (Optional) You can enter the name
  3250.                                        of this area for QWK mail packers.
  3251.                                        QWK only supports up to 12
  3252.                                        characters for area names.
  3253.  
  3254.          Reply Area .................. The area where replies to messages
  3255.                                        in this area should be posted.
  3256.                                        Useful for allowing users to reply
  3257.                                        to "To-All" messages.  Set this to
  3258.                                        "0" (zero) if you want replies to go
  3259.                                        to the current message area.
  3260.  
  3261.          SysOp ....................... The user name for an "Area SysOp".
  3262.                                        A user with this name will have full
  3263.                                        SysOp access to this message area.
  3264.                                        When users write messages to "SysOp"
  3265.                                        in this area, the messages will be
  3266.                                        sent to the user name specified here.
  3267.  
  3268.          Group #1 .................... The first group number this message
  3269.                                        area belongs to (1-255) if any.
  3270.  
  3271.          Group #2 .................... The second group number this message
  3272.                                        area belongs to (1-255) if any.
  3273.  
  3274.          Group #3 .................... The third group number this message
  3275.                                        area belongs to (1-255) if any.
  3276.  
  3277.          Group #4 .................... The fourth group number this message
  3278.                                        area belongs to (1-255) if any.
  3279.  
  3280.          All Groups .................. Does this message area belong to all
  3281.                                        message groups?  Press the <SpaceBar>
  3282.                                        to toggle between Yes/No.
  3283.  
  3284.  
  3285.  
  3286.                                       - 58 -
  3287.  
  3288.  
  3289.  
  3290.          Kill after <xx> days ........ When running the PBUTIL message
  3291.                                        packer with the -D parameter, all
  3292.                                        messages that have been in the
  3293.                                        message base for <xx> days will be
  3294.                                        deleted.  This is for both HUDSON
  3295.                                        and JAM message base formats.
  3296.  
  3297.          Kill rcvd after <xx> days ... When running the PBUTIL message
  3298.                                        packer with the -D parameter, all
  3299.                                        messages that have been received
  3300.                                        for <xx> days will be deleted.
  3301.                                        This is only for HUDSON or JAM
  3302.                                        message base formats.
  3303.  
  3304.          Max # messages .............. The maximum number of messages
  3305.                                        allowed in this area. When this
  3306.                                        number is exceeded, PBUTIL MP -D
  3307.                                        (message pack & delete) will delete
  3308.                                        the oldest messages from the
  3309.                                        message base (Hudson and Squish).
  3310.  
  3311.  
  3312.  
  3313.          ┌─────────────────────────────────────────────────────────────────┐
  3314.          │ Message Area Groups - (F4)                                      │
  3315.          └─────────────────────────────────────────────────────────────────┘
  3316.  
  3317.          ProBoard allows you to configure up to 255 Message Area Groups
  3318.          for your system.  Message groups can be used to place message
  3319.          areas of similar interest into a group users can select from.
  3320.  
  3321.          If you run a BBS that caters to programmers, and also to people
  3322.          who enjoy gardening, you may want to create two separate message
  3323.          area groups so programmers aren't reading about pruning roses,
  3324.          and gardeners aren't reading about array elements  :-)
  3325.  
  3326.          When you select "Message Area Groups" a window is displayed
  3327.          showing any installed message groups (if any).  To add a message
  3328.          area group press <Ins>.  To delete a message area group, press
  3329.          <DEL>.  To edit a message area group that already exists, press
  3330.          <Enter> with the highlight bar on the group you want to edit.
  3331.  
  3332.          When you press <Ins> to add a new message group, a dialog will
  3333.          be displayed asking for the group number.  Press <ENTER> to
  3334.          accept the next available area, or type a number (between 1 and
  3335.          255) for the message area group you want to create.
  3336.  
  3337.  
  3338.  
  3339.  
  3340.  
  3341.  
  3342.                                       - 59 -
  3343.  
  3344.  
  3345.  
  3346.          The fields that make up a message group are as follows:
  3347.          ───────────────────────────────────────────────────────
  3348.  
  3349.          Area Name ................... The area name that will be
  3350.                                        displayed to users when selecting
  3351.                                        from your message area groups.
  3352.  
  3353.          Access Level ................ The minimum security level needed
  3354.                                        for a user to be able to see/select
  3355.                                        this message area group.
  3356.  
  3357.          Access Flags ................ The access flags needed (or not
  3358.                                        needed) to access this message area
  3359.                                        group.
  3360.  
  3361.  
  3362.          Once a message area group has been defined, refer to Menu
  3363.          Function 49 (Select Message Area) for the options needed to
  3364.          allow your users access to it.
  3365.  
  3366.  
  3367.  
  3368.          ┌─────────────────────────────────────────────────────────────────┐
  3369.          │ File Areas - (F5)                                               │
  3370.          └─────────────────────────────────────────────────────────────────┘
  3371.  
  3372.          File areas are used to setup and categorize your downloadable
  3373.          files.  You can prevent groups of users from accessing certain
  3374.          file areas with the use of Access Levels and/or Access Flags.
  3375.          ProBoard uses an advanced file index to locate files as
  3376.          defined here in your file areas.  Once you have configured your
  3377.          file areas, you MUST run PBUTIL FI (file index) to create the
  3378.          index in order for ProBoard to find the files for users to
  3379.          download.
  3380.  
  3381.  
  3382.          A file area has the following fields:
  3383.          ─────────────────────────────────────
  3384.  
  3385.  
  3386.          Area Name ................... Name of this file area.  Displayed
  3387.                                        to users on the BBS on the file
  3388.                                        selection list.
  3389.  
  3390.  
  3391.  
  3392.  
  3393.  
  3394.  
  3395.  
  3396.  
  3397.  
  3398.                                       - 60 -
  3399.  
  3400.  
  3401.  
  3402.          File Location ............... Directory where the files for this
  3403.                                        area are physically located.  It is
  3404.                                        also possible to specify multiple
  3405.                                        directories per file area.  To do
  3406.                                        this, enter the first file directory
  3407.                                        here, then create a file in your
  3408.                                        ProBoard system directory (usually
  3409.                                        C:\PB) called FA_<area>.CTL.  Place
  3410.                                        each additional file directory (one
  3411.                                        directory per line) in this file to
  3412.                                        tell ProBoard where to find the
  3413.                                        additional directories for this file
  3414.                                        area.
  3415.  
  3416.                                        Example:  for file area #10 (Games),
  3417.                                        which has a total of 4 directories,
  3418.                                        place the first directory in the
  3419.                                        "File Location" slot in PROCFG, then
  3420.                                        create a file called FA_10.CTL. In
  3421.                                        this file, place the additional
  3422.                                        directories one per line like this:
  3423.  
  3424.                                        D:\DLOAD\GAMES2
  3425.                                        D:\DLOAD\GAMES3
  3426.                                        D:\DLOAD\GAMES4
  3427.  
  3428.                                        Use an ascii editor like QEDIT, or
  3429.                                        the DOS editor to create this file.
  3430.  
  3431.          Listing File ................ Full path & filename of the file in
  3432.                                        which the downloadable files are
  3433.                                        described.  This files is often
  3434.                                        called FILES.BBS.  Refer to Menu
  3435.                                        Function 31, in the chapter on
  3436.                                        Menus.
  3437.  
  3438.                                        Sample: C:\PB\DLOAD\FILES.BBS)
  3439.  
  3440.          Access Flags ................ Flags needed to download files in
  3441.                                        this area.  You can now specify
  3442.                                        flags that a user MUST NOT have to
  3443.                                        access this file area.  These flags
  3444.                                        are displayed in reverse.  To set a
  3445.                                        reverse flag - type the flag letter
  3446.                                        twice until you see it display in
  3447.                                        reverse.  To clear a reverse flag
  3448.                                        type the flag letter again.
  3449.  
  3450.          Access Level ................ Level needed to download files in
  3451.                                        this area.
  3452.  
  3453.  
  3454.                                       - 61 -
  3455.  
  3456.  
  3457.  
  3458.          Copy Local .................. Setting this option to "Yes" (use
  3459.                                        the <SPACEBAR> to toggle), tells
  3460.                                        ProBoard whether or not to use
  3461.                                        it's CD-ROM specific file listing
  3462.                                        formats.  In addition, it tells
  3463.                                        ProBoard to copy the files in this
  3464.                                        file area to a different location,
  3465.                                        usually a local drive before a
  3466.                                        download of the file begins.  This
  3467.                                        is ideal for CD-ROM or Network
  3468.                                        drives since it frees up these
  3469.                                        resources for other users to access
  3470.                                        them.
  3471.  
  3472.          It's important to understand that ProBoard now determines the
  3473.          format of "FILES.BBS" itself.  This will assist you in using
  3474.          CD-ROM's on your BBS that have different "FILES.BBS" formats.
  3475.  
  3476.          The "FILES.BBS" can have any of the following formats:
  3477.          ──────────────────────────────────────────────────────
  3478.  
  3479.                   <filename> <description>
  3480.                   <filename> <size> <date> <description>
  3481.                   <filename> <date> <size> <description>
  3482.                   <filename> <size> <description>
  3483.                   <filename> <date> <description>
  3484.  
  3485.          Any missing information ( <date> or <size> ) will be retrieved
  3486.          from the CD-ROM or Network drive by ProBoard.  If only the <date>
  3487.          is specified in your "FILES.BBS", ProBoard will need to retrieve
  3488.          the <size> of the file from the disk in order to display your file
  3489.          listing for this area to your users.  If both the <date> and
  3490.          <size> are specified, (the preferred format for your "FILES.BBS")
  3491.          ProBoard will not need to check the CD-ROM or Network drive for
  3492.          this information.
  3493.  
  3494.  
  3495.  
  3496.  
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502.  
  3503.  
  3504.  
  3505.  
  3506.  
  3507.  
  3508.  
  3509.  
  3510.                                       - 62 -
  3511.  
  3512.  
  3513.  
  3514.          Hot Tip!
  3515.          ────────
  3516.          Use "FILES.BBS" listings that include <date> -and- <size> whenever
  3517.          possible, to prevent ProBoard from accessing your CD-ROM or
  3518.          Network drives.  This will give your BBS optimum performance when
  3519.          users choose to list your files.
  3520.  
  3521.  
  3522.          ProBoard will also copy files from CD-ROM or Network drives to a
  3523.          local drive when the "Copy Local" flag is set to "Yes".  Files
  3524.          will be copied to a directory called "CD_TEMP", which will
  3525.          be created by ProBoard, off of the directory from which ProBoard
  3526.          was started from.  You can specify your own directory by creating
  3527.          a DOS environment variable called CDTEMP containing the name of
  3528.          the drive -and- directory.
  3529.  
  3530.          How to create your own "Copy Local" directory:
  3531.          ──────────────────────────────────────────────
  3532.          1.) Decide on and create the directory where you want the
  3533.              files from the CD-ROM or Network to be copied into.  For
  3534.              example, C:\MYDIR\CDFILES
  3535.  
  3536.          2.) Add the following line to your "AUTOEXEC.BAT" file:
  3537.  
  3538.                   SET CDTEMP=C:\MYDIR\CDFILES
  3539.  
  3540.  
  3541.          If ProBoard can not find the directory as specified it will
  3542.          attempt to create it, and if it can't will revert to using the
  3543.          CD_TEMP directory off of the directory the ProBoard was started
  3544.          from.
  3545.  
  3546.  
  3547.          In TOPFILES.................. Determines whether or not this file
  3548.                                        area is included when TOPFILES.A??
  3549.                                        is created.  Refer to PBUTIL FC for
  3550.                                        more information.
  3551.  
  3552.          Free Area ................... Specifies whether or not ALL files
  3553.                                        in this file area are FREE files.
  3554.                                        If this is set to 'Yes', any files
  3555.                                        a user downloads from this area will
  3556.                                        not be deducted from their download
  3557.                                        limits.
  3558.  
  3559.          Group #1 .................... The first group number this file
  3560.                                        area belongs to (1-255) if any.
  3561.  
  3562.          Group #2 .................... The second group number this file
  3563.                                        area belongs to (1-255) if any.
  3564.  
  3565.  
  3566.                                       - 63 -
  3567.  
  3568.  
  3569.  
  3570.          Group #3 .................... The third group number this file
  3571.                                        area belongs to (1-255) if any.
  3572.  
  3573.          Group #4 .................... The fourth group number this file
  3574.                                        area belongs to (1-255) if any.
  3575.  
  3576.          All Groups .................. Does this file area belong to all
  3577.                                        file groups?  Press the <SpaceBar>
  3578.                                        to toggle between Yes/No.
  3579.  
  3580.          Max. files................... Maximum number of files that can be
  3581.                                        downloaded from this area per
  3582.                                        user per day (0 means unlimited).
  3583.  
  3584.          Max. Kb...................... Maximum number of Kbytes that can be
  3585.                                        downloaded from this area per
  3586.                                        user per day (0 means unlimited).
  3587.  
  3588.          FILES.BBS Date Format ....... The date format that is used in
  3589.                                        this area's FILES.BBS file.  You
  3590.                                        have to change this if FILES.BBS
  3591.                                        contains dates in a different format
  3592.                                        than "MM/DD/YY" of "MM-DD-YY"
  3593.                                        (CD-ROMs from Europe for example).
  3594.                                        If you don't set this so it matches
  3595.                                        the date format in FILES.BBS,
  3596.                                        ProBoard will not be able to
  3597.                                        correctly read the dates listed in
  3598.                                        your file list.
  3599.  
  3600.  
  3601.  
  3602.          ┌─────────────────────────────────────────────────────────────────┐
  3603.          │ File Area Groups - F6                                           │
  3604.          └─────────────────────────────────────────────────────────────────┘
  3605.  
  3606.          ProBoard allows you to configure up to 255 File Area Groups
  3607.          for your system.  File groups can be used to place files of
  3608.          similar interest into a group users can select from.
  3609.  
  3610.          If you run a BBS that caters to programmers, and also to people
  3611.          who enjoy gardening, you may want to create two separate file
  3612.          area groups so programmers aren't downloading files about pruning
  3613.          roses, and gardeners aren't downloading files about array
  3614.          elements  :-)
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.                                       - 64 -
  3623.  
  3624.  
  3625.  
  3626.          When you select "File Area Groups" a window is displayed showing
  3627.          any installed file groups (if any).  To add a file area group
  3628.          press <Ins>.  To delete a file area group, press <DEL>.  To edit
  3629.          a file area group that already exists, press <Enter> with the
  3630.          highlight bar on the group you want to edit.
  3631.  
  3632.          When you press <Ins> to add a new file group, a dialog will
  3633.          be displayed asking for the group number.  Press <ENTER> to
  3634.          accept the next available area, or type a number (between 1 and
  3635.          255) for the file area group you want to create.
  3636.  
  3637.          The fields that make up a file group are as follows:
  3638.          ────────────────────────────────────────────────────
  3639.  
  3640.          Area Name ................... The area name that will be
  3641.                                        displayed to users when selecting
  3642.                                        from your file area groups.
  3643.  
  3644.          Access Level ................ The minimum security level needed
  3645.                                        for a user to be able to see/select
  3646.                                        this file area group.
  3647.  
  3648.          Access Flags ................ The access flags needed (or not
  3649.                                        needed) to access this file area
  3650.                                        group.
  3651.  
  3652.  
  3653.          Once a file area group has been defined, refer to Menu Function
  3654.          54 (Select New File Area) for the options needed to allow your
  3655.          users access to it.
  3656.  
  3657.  
  3658.  
  3659.          ┌─────────────────────────────────────────────────────────────────┐
  3660.          │ Time/Download Limits  - (F7)                                    │
  3661.          └─────────────────────────────────────────────────────────────────┘
  3662.  
  3663.          In ProBoard you can grant different groups of users different
  3664.          rights concerning download limits and maximum online time per day.
  3665.          Additionally, you can limit downloading in a very powerful and
  3666.          flexible way.  This is done by defining user levels.
  3667.  
  3668.  
  3669.  
  3670.  
  3671.  
  3672.  
  3673.  
  3674.  
  3675.  
  3676.  
  3677.  
  3678.                                       - 65 -
  3679.  
  3680.  
  3681.  
  3682.          Editing user levels is done in by pressing <Ins> to add a
  3683.          security level, <Del> to delete a security level, and <Enter> to
  3684.          edit an existing security level.
  3685.  
  3686.  
  3687.          These are the fields to be specified for each level:
  3688.          ────────────────────────────────────────────────────
  3689.  
  3690.          Security Level .............. The user level you are editing.
  3691.  
  3692.          Time Per Day ................ Time a user with this level can
  3693.                                        spend on your system each day.
  3694.  
  3695.          Kb Download Per Day ......... Daily download-limit associated with
  3696.                                        this user level (in Kbytes/day).
  3697.  
  3698.          Download Delay .............. Time a user must spend online each
  3699.                                        call before a download can be made.
  3700.                                        (Great to calm down excessive
  3701.                                        downloaders).
  3702.  
  3703.          Usergroup ID ................ String of max. 5 characters that
  3704.                                        identifies this level, eg. NEW,
  3705.                                        REG, VIP, etc.  This is optional.
  3706.                                        These ID's will be shown when the
  3707.                                        userlist is displayed (Refer to
  3708.                                        Menu Function 13).
  3709.  
  3710.          Free Download ............... The amount that can be downloaded
  3711.                                        by users with this level, without
  3712.                                        having to upload or write messages.
  3713.  
  3714.          Upload Needed ............... The percentage of total downloads
  3715.                                        the user has to upload.
  3716.                                        Eg. if the upload factor is 15%, and
  3717.                                        a user has downloaded 1000Kb, he
  3718.                                        will have to upload 150Kb.
  3719.                                        Setting this to 0 allows the users
  3720.                                        to download as much as they want,
  3721.                                        until the download limit (see below)
  3722.                                        is reached. Of course, it is
  3723.                                        impossible to download more than the
  3724.                                        daily maximum each day.
  3725.  
  3726.  
  3727.  
  3728.  
  3729.  
  3730.  
  3731.  
  3732.  
  3733.  
  3734.                                       - 66 -
  3735.  
  3736.  
  3737.  
  3738.          Free Download/Msg ........... The amount of Kilobytes that can be
  3739.                                        downloaded free for each message
  3740.                                        written. This rewards busy message-
  3741.                                        writers by increasing their download-
  3742.                                        limit. The amount of kilobytes is
  3743.                                        added to the free download number
  3744.                                        (see above)
  3745.  
  3746.          Maximum Download ............ When this limit is set to a positive
  3747.                                        non-zero value, and a user reaches
  3748.                                        this limit, his/her level will be
  3749.                                        changed to the "Fall To" level.  Be
  3750.                                        careful when changing this to a
  3751.                                        value other than 0 (zero).  Doing so
  3752.                                        may lock out a user if the "Fall To
  3753.                                        Level" (below) is set to zero.  Your
  3754.                                        user may not be too happy with your
  3755.                                        BBS should this happen.
  3756.  
  3757.          Fall To Level ............... Security Level which user should be
  3758.                                        assigned when they reach the (above)
  3759.                                        "Maximum Download" setting.
  3760.  
  3761.  
  3762.  
  3763.          ┌─────────────────────────────────────────────────────────────────┐
  3764.          │ User Editor (F8)                                                │
  3765.          └─────────────────────────────────────────────────────────────────┘
  3766.  
  3767.          Working with your users records using the User Editor is easy.
  3768.          You can use the user editor to locate/view/change information in a
  3769.          users record.  You can also edit a users record while they are
  3770.          on-line by pressing <Alt-E>.
  3771.  
  3772.  
  3773.          Both ways of editing a users record in ProBoard are virtually
  3774.          identical.  ProBoard keeps a user's record in memory while they
  3775.          are online and then writes it back to the user file once they
  3776.          log off.  If you want to make changes to a user's record who is
  3777.          online, it is important to use the <Alt-E> method since you will
  3778.          be editing their record in memory.  If you use the user editor in
  3779.          PROCFG.EXE to edit the record of a user who is online, any changes
  3780.          you make will be written over by the user record in memory when
  3781.          they log off.
  3782.  
  3783.  
  3784.  
  3785.  
  3786.  
  3787.  
  3788.  
  3789.  
  3790.                                       - 67 -
  3791.  
  3792.  
  3793.  
  3794.  
  3795.  
  3796.          You can use the following keys in the user editor:
  3797.          ──────────────────────────────────────────────────
  3798.  
  3799.          <PgUp> ...................... Go to the previous user-record.
  3800.  
  3801.          <PgDn> ...................... Go to the next user-record.
  3802.  
  3803.          <Ctrl-PgUp> ................. Go to the first user-record.
  3804.  
  3805.          <Ctrl-PgDn> ................. Go to the last user-record.
  3806.  
  3807.          <ESC> ....................... Exits the User Editor.
  3808.  
  3809.          <Alt-A> ..................... Add a new user record.
  3810.  
  3811.          <Alt-D> ..................... Toggle the 'deleted' flag of the
  3812.                                        current user.
  3813.  
  3814.          <Alt-F> ..................... Shows flag descriptions for flags
  3815.                                        you have defined on your BBS.  After
  3816.                                        pressing <Alt-F> another window will
  3817.                                        appear showing the flags and any
  3818.                                        descriptions you have defined for
  3819.                                        them.  You can add/edit descriptions
  3820.                                        for your flags by pressing <Alt-E>
  3821.                                        in this window, then using the Up
  3822.                                        and Down arrows to position on the
  3823.                                        flag.  Then simply type the
  3824.                                        description you want and press <ESC>
  3825.                                        to exit that field, and <ESC> once
  3826.                                        again to exit the flag description
  3827.                                        window.
  3828.  
  3829.          <Alt-L> ..................... Opens a secondary window listing
  3830.                                        your user records.  Several powerful
  3831.                                        functions are available here to make
  3832.                                        finding and editing your users much
  3833.                                        easier.  Press the <F1> key, and
  3834.                                        ProBoard will display a help screen
  3835.                                        containing information on the
  3836.                                        following items.
  3837.  
  3838.                           <PgUp> ..... Moves to the previous screen page of
  3839.                                        user records.
  3840.  
  3841.                           <PgDn> ..... Moves to the next screen page of
  3842.                                        user records.
  3843.  
  3844.  
  3845.  
  3846.                                       - 68 -
  3847.  
  3848.  
  3849.  
  3850.                           <Home> ..... Moves to the first record in the
  3851.                                        user file.
  3852.  
  3853.                            <End> ..... Moves to the last record in the user
  3854.                                        user file.
  3855.  
  3856.                            <Esc> ..... Closes the user list window and
  3857.                                        returns to the user editor,
  3858.                                        positioned on the first record in
  3859.                                        the user file.
  3860.  
  3861.                          <Enter> ..... Closes the user list window and
  3862.                                        returns to the user editor,
  3863.                                        positioned on the user record you
  3864.                                        were on in the user list window.
  3865.  
  3866.                          <1...9> ..... Begin typing the record number you
  3867.                                        want to go to in the user file.  A
  3868.                                        window will appear showing you the
  3869.                                        number as you type it.  Press
  3870.                                        <ENTER> to jump to the record you
  3871.                                        have entered, or <ESC> to return to
  3872.                                        the user list.
  3873.  
  3874.                          <A...Z> ..... Begin typing a name or part of a
  3875.                                        name to search for in the user
  3876.                                        file.  This activates the search
  3877.                                        dialog window.  Once you have entered
  3878.                                        the name you want to search for,
  3879.                                        press <ENTER> to begin the search.
  3880.                                        You can press <ESC> at any point
  3881.                                        during the search, to abort the
  3882.                                        search and return to the user list.
  3883.                                        If the search finds a record
  3884.                                        matching what you entered, you can
  3885.                                        press <ENTER> to edit that record,
  3886.                                        or press <Alt-N> to find the next
  3887.                                        occurrence of your search criteria.
  3888.  
  3889.  
  3890.  
  3891.  
  3892.  
  3893.  
  3894.  
  3895.  
  3896.  
  3897.  
  3898.  
  3899.  
  3900.  
  3901.  
  3902.                                       - 69 -
  3903.  
  3904.  
  3905.  
  3906.                          <Alt-F> ..... Activates a window asking if you
  3907.                                        want to enable the user list
  3908.                                        filter.  If you select "No", you are
  3909.                                        returned to the user list.  If you
  3910.                                        select "Yes", the user list filter
  3911.                                        dialog window is activated.  By
  3912.                                        filling in various items in the
  3913.                                        filter dialog, you can limit the
  3914.                                        scope of the user records displayed
  3915.                                        in the user list.  Once a filter is
  3916.                                        in effect, only the user records
  3917.                                        matching the filter condition are
  3918.                                        displayed in the user list.  You
  3919.                                        can then move thru the records
  3920.                                        displayed, editing them and using
  3921.                                        any other user list keys as you
  3922.                                        normally would.  To disable a
  3923.                                        filter, press <Alt-F> and select
  3924.                                        "No" when asked "Enable filter?".
  3925.                                        Closing the user editor also
  3926.                                        cancels any filter in effect.
  3927.  
  3928.                          <Alt-G> ..... Activates a window asking what user
  3929.                                        record you want to go to in the user
  3930.                                        list.  Either enter a number and
  3931.                                        press <ENTER> to go to that user
  3932.                                        record, or press <ESC> to return to
  3933.                                        the user list.
  3934.  
  3935.                          <Alt-S> ..... Activates the search dialog window.
  3936.                                        Once you have entered the name you
  3937.                                        want to search for press <ENTER> to
  3938.                                        begin the search.  You can press
  3939.                                        <ESC> at any point during the
  3940.                                        search, to abort the search and
  3941.                                        return to the user list.  If the
  3942.                                        search finds a record matching what
  3943.                                        you entered, you can press <ENTER>
  3944.                                        to edit that record or press <Alt-N>
  3945.                                        to find the next occurrence of your
  3946.                                        search criteria.
  3947.  
  3948.                          <Alt-N> ..... Finds the next occurrence (if any) of
  3949.                                        search criteria specified with the
  3950.                                        <Alt-S> (search) option (above).
  3951.  
  3952.          <Alt-N> ..................... Searches for the next user-record
  3953.                                        matching the search criteria
  3954.                                        specified with <Alt-S>.
  3955.  
  3956.  
  3957.  
  3958.                                       - 70 -
  3959.  
  3960.  
  3961.  
  3962.          <Alt-P> ..................... Toggles the Password Hide/UnHide
  3963.                                        option when viewing user records.
  3964.                                        The character that is displayed when
  3965.                                        passwords are hidden is defined in
  3966.                                        PROCFG, [F1] Options, System
  3967.                                        Options, in the "Password Display"
  3968.                                        field.  When viewing a user record
  3969.                                        where the password is hidden, simply
  3970.                                        press <ENTER> when positioned on the
  3971.                                        hidden password, and ProBoard will
  3972.                                        display the user's password in a
  3973.                                        window.
  3974.  
  3975.          <ALT-R> ....................  Restore User Record.  If you are
  3976.                                        editing a user's record and change
  3977.                                        your mind, you can use this option
  3978.                                        to restore the user record to it's
  3979.                                        original values.
  3980.  
  3981.          <Alt-S> ....................  Searches for a user-record.  You may
  3982.                                        optionally specify either part of,
  3983.                                        or the full name of the user you are
  3984.                                        searching for.  The search uses
  3985.                                        "fuzzy" logic, meaning that it will
  3986.                                        find user names containing strings
  3987.                                        that are close to what you type.
  3988.                                        How accurate the fuzzy search is
  3989.                                        depends on the setting in PROCFG,
  3990.                                        [F1] Options, System Options, in the
  3991.                                        "FuzzySearch Rate" field.
  3992.  
  3993.          <ALT-V> ..................... Validate User.  Opens a window
  3994.                                        containing any validation templates
  3995.                                        defined in the PROCFG, [Shift-F6]
  3996.                                        Validate Template Editor.  (Refer to
  3997.                                        the "Configuration" section of this
  3998.                                        manual under "Validate Template
  3999.                                        Editor" for more information on
  4000.                                        setting up your templates.)  Select
  4001.                                        one of the templates, and ProBoard
  4002.                                        will update the user record with the
  4003.                                        values defined in the template,
  4004.                                        asking you for confirmation first.
  4005.                                        Press <ESC> at any point during the
  4006.                                        validation to abort the validation.
  4007.  
  4008.  
  4009.  
  4010.  
  4011.  
  4012.  
  4013.  
  4014.                                       - 71 -
  4015.  
  4016.  
  4017.  
  4018.          <F10> ....................... Opens a secondary window containing
  4019.                                        additional information about the
  4020.                                        current user.  Once this window is
  4021.                                        displayed, you may display/edit the
  4022.                                        following items.
  4023.  
  4024.                - Times Called.
  4025.                - Total Number of Downloads.
  4026.                - Total KB of Downloads.
  4027.                - Total Number of Uploads.
  4028.                - Total KB of Uploads.
  4029.                - Number of Messages User has posted.
  4030.                - Total Time user has spent online to date.
  4031.  
  4032.                - Amount of Time user has spent online today. If the user
  4033.                  has not been online today, there may still be a value in
  4034.                  this field.  This field is cleared by ProBoard upon a
  4035.                  users first call of each day.
  4036.  
  4037.                - Total KB downloaded today.
  4038.                - Time Balance in the users bank account.
  4039.                - Time Withdrawn from users bank account.
  4040.                - Time Deposited in users bank account.
  4041.                - Time user has borrowed from TheBank.
  4042.                - Payback date for time user borrowed from TheBank.
  4043.  
  4044.                - Kbyte Balance user has banked.
  4045.                - Kbytes user has withdrawn from TheBank.
  4046.                - Kbytes user has deposited.
  4047.                - Kbytes user has borrowed.
  4048.                - Payback date for Kbytes borrowed.
  4049.                - Date last used the time bank.
  4050.  
  4051.          When you have found the user-record you are looking for, move
  4052.          between the fields by using the arrow keys. To edit a field, just
  4053.          move the selector to that field and begin typing.
  4054.  
  4055.          A user record has the following fields:
  4056.          ───────────────────────────────────────
  4057.  
  4058.          User Name ................... User's name.
  4059.  
  4060.          Alias ....................... Each user can have a unique 'alias'
  4061.                                        (nickname). In selected message
  4062.                                        areas, the user can use this alias
  4063.                                        to write messages or (if enabled)
  4064.                                        can login using this alias.
  4065.  
  4066.          Password .................... User's password.
  4067.  
  4068.  
  4069.  
  4070.                                       - 72 -
  4071.  
  4072.  
  4073.  
  4074.          City ........................ City the user lives in.
  4075.  
  4076.          State ....................... State the user lives in.
  4077.  
  4078.          Country ..................... Country the user lives in.
  4079.  
  4080.          Address 1 ................... Users address, line 1 of 3
  4081.  
  4082.          Address 2 ................... Users address, line 2 of 3
  4083.  
  4084.          Address 3 ................... Users address, line 3 of 3
  4085.  
  4086.          Forward To .................. (not implemented yet)
  4087.  
  4088.          Level ....................... User's security level (ranging from
  4089.                                        0 to 64000).  A 0 (zero) means that
  4090.                                        the user has NO access to the BBS.
  4091.  
  4092.          Flags ....................... User's flags. Edit them by pressing
  4093.                                        <Enter>, and then pressing any
  4094.                                        character ranging from A thru Z and
  4095.                                        1 thru 6 to toggle that flag.  Press
  4096.                                        the <F1> key to view/edit any flag
  4097.                                        definitions for your BBS.
  4098.  
  4099.          Expiration Date ............. When this date is specified
  4100.                                        (non-zero), the user's security
  4101.                                        level will drop to the level
  4102.                                        specified in the "Expiration
  4103.                                        Level" field (below).
  4104.  
  4105.          Expiration Level ............ The new security level assigned to a
  4106.                                        user when the "Expiration Date" (if
  4107.                                        other than 0) is reached.
  4108.  
  4109.          Expiration Flags On ......... User flags to turn on when
  4110.                                        expiration date is reached.
  4111.  
  4112.          Expiration Flags Off ........ User flags to turn off when
  4113.                                        expiration date is reached.
  4114.  
  4115.          Comment ..................... This field allows you to enter
  4116.                                        comments about this particular user.
  4117.  
  4118.          Voice Phone ................. User's voice phone number (not
  4119.                                        restricted to a certain layout).
  4120.  
  4121.          Data Phone .................. User's data number (if any).
  4122.  
  4123.          FAX Phone ................... User's FAX number (if any).
  4124.  
  4125.  
  4126.                                       - 73 -
  4127.  
  4128.  
  4129.  
  4130.          Birth Date .................. The date of birth of this user.
  4131.                                        This will be recorded if you turn on
  4132.                                        the option to ask new users for
  4133.                                        their birth date upon initial login.
  4134.                                        Directly to the right of the birth
  4135.                                        date field is a number in brackets.
  4136.                                        This number is the users age, as
  4137.                                        calculated by ProBoard based on the
  4138.                                        date entered into the birth date
  4139.                                        field.  If you change the users
  4140.                                        birth date, you must save the record
  4141.                                        in order for the calculation of the
  4142.                                        users age to take place.
  4143.  
  4144.          Sex ......................... User's sex.  Toggle options with the
  4145.                                        space bar.
  4146.  
  4147.          Date Format ................. The date format this user prefers to
  4148.                                        use.  Toggle through the allowable
  4149.                                        formats by pressing the right-arrow
  4150.                                        and left-arrow while positioned on
  4151.                                        this field.
  4152.  
  4153.          Screen Height ............... Number of screen lines for this user.
  4154.  
  4155.          Default Protocol ............ The default file transfer protocol
  4156.                                        this user has selected.
  4157.  
  4158.          Language .................... The language file the user selected
  4159.                                        from the list of available languages
  4160.                                        on your BBS.  If no languages are
  4161.                                        available or the user pressed
  4162.                                        <ENTER> when asked to select a
  4163.                                        language then ENGLISH is used as the
  4164.                                        default.  You can edit the users
  4165.                                        language selection but you must type
  4166.                                        the language name.
  4167.  
  4168.          Log Level ................... The way in which entries about this
  4169.                                        users calls will be written to
  4170.                                        PROBOARD.LOG  Use the Space Bar to
  4171.                                        toggle between "Normal",
  4172.                                        "Suspicious","Extensive", and
  4173.                                        "Friend".
  4174.  
  4175.          Terminal .................... Users Terminal Setting.  Press the
  4176.                                        <Spacebar> to toggle between "ANSI",
  4177.                                        "Avatar", "Avt/0+", and "TTY".
  4178.  
  4179.  
  4180.  
  4181.  
  4182.                                       - 74 -
  4183.  
  4184.  
  4185.  
  4186.          NetMail Credit .............. Number of credits the user has left
  4187.                                        to write Netmail messages.
  4188.  
  4189.          First Call .................. The date of the user's first call to
  4190.                                        your system.  This field is display
  4191.                                        only.
  4192.  
  4193.          Last Call ................... The date of this users last call to
  4194.                                        your system.  This field is display
  4195.                                        only.
  4196.  
  4197.          Deleted ..................... If this is set to "Yes", this users
  4198.                                        record will be removed from your
  4199.                                        user file the next time you run
  4200.                                        PBUTIL UP (User Packer) to pack the
  4201.                                        user file.
  4202.  
  4203.          More Prompt ................. Pause after each screen page?
  4204.  
  4205.          Clear Screen ................ Send screen clearing codes to the
  4206.                                        user?
  4207.  
  4208.          Hot Keys .................... Hot Keys enabled?  If set to "Yes"
  4209.                                        user can hot key thru your menus.
  4210.                                        If set to "No" then command-stacking
  4211.                                        will be used instead.
  4212.  
  4213.          IBM ......................... If set to "Yes" all IBM-specific
  4214.                                        characters will be filtered out and
  4215.                                        converted to standard ASCII.  If set
  4216.                                        to "No" then IBM characters will be
  4217.                                        sent.
  4218.  
  4219.          Full Screen Editor .......... If set to "Yes", then the fullscreen
  4220.                                        message editor (defined in PROCFG,
  4221.                                        F1, Paths, Editor Command) will be
  4222.                                        used when this user enters messages.
  4223.                                        If set to "No" then ProBoard will
  4224.                                        use it's internal line editor
  4225.                                        instead.
  4226.  
  4227.          NoKill ...................... If set to "Yes" the user's record
  4228.                                        CAN NOT be removed from the userfile
  4229.                                        when using PBUTIL UK (User Killer)
  4230.                                        or PBUTIL UP (User Packer).
  4231.  
  4232.          Ignore Download ............. Does this user have UNLIMITED
  4233.                                        downloadⁿaccess?  If set to "Yes",
  4234.                                        ProBoard will ignore download limits
  4235.                                        for this user.
  4236.  
  4237.  
  4238.                                       - 75 -
  4239.  
  4240.  
  4241.  
  4242.          Attention ................... If set to "Yes", ProBoard will play
  4243.                                        the file "ATTEN.MUS" when this user
  4244.                                        logs on.  The file "ATTEN.MUS" must
  4245.                                        be located in your ProBoard System
  4246.                                        Directory (usually C:\PB).
  4247.  
  4248.          No Tops ..................... If set to "Yes", then this user will
  4249.                                        be excluded from any of the "tops"
  4250.                                        lists that ProBoard creates. (Refer
  4251.                                        to Menu Function 48 for more info).
  4252.  
  4253.          Hidden ...................... If enabled, ProBoard will hide this
  4254.                                        users activity from the "Last
  4255.                                        Callers List" (Menu Function 51),
  4256.                                        "Show Users Online" (Menu Function
  4257.                                        50), and from the "User List (Menu
  4258.                                        Function 13).
  4259.  
  4260.          Guest ....................... Allows this user to have "guest
  4261.                                        account" status.  This means their
  4262.                                        daily totals for minutes online,
  4263.                                        files downloaded, etc., will be
  4264.                                        reset on each call of the day, and
  4265.                                        not just on their first call of each
  4266.                                        day.
  4267.  
  4268.          Free Chat ................... If set to "Yes", ProBoard will
  4269.                                        freeze the system timer when you and
  4270.                                        this user are chatting.  This means
  4271.                                        no time will be deducted from a
  4272.                                        users online time when chatting.
  4273.  
  4274.          Local Only .................. If enabled, this user is not allowed
  4275.                                        to log in remotely, they can only
  4276.                                        use the local console to login.
  4277.  
  4278.          RIP ......................... If set to "Yes" then RIP graphics
  4279.                                        will be sent to this user.  If set
  4280.                                        to "No" RIP graphics will not be
  4281.                                        sent to the user even if RIP is
  4282.                                        detected.
  4283.  
  4284.  
  4285.  
  4286.          ┌─────────────────────────────────────────────────────────────────┐
  4287.          │ Menu Editor (F9)                                                │
  4288.          └─────────────────────────────────────────────────────────────────┘
  4289.  
  4290.          Creating menus for ProBoard is extremely easy using the built-in
  4291.          Menu Editor.
  4292.  
  4293.  
  4294.                                       - 76 -
  4295.  
  4296.  
  4297.  
  4298.          When you select the "Menu Editor" option in PROCFG's main menu, a
  4299.          new window is opened containing the defined languages.  ProBoard
  4300.          allows you to have a language specific set of menus for each
  4301.          language you define.  Refer to the "Language Editor" portion of
  4302.          the manual for more information on specifying paths for your
  4303.          language specific menus.  If no path is given, the default menu
  4304.          path defined in PROCFG, (F1) Options, Paths, Menus is used.
  4305.  
  4306.          Once you have selected the language whose menus you want to edit,
  4307.          a second window is opened displaying the menu names that are
  4308.          available to edit.  A menu must already exist to be displayed in
  4309.          this window.
  4310.  
  4311.          You can type the first few letters of a menu name to jump to that
  4312.          menu in the choice list, or use the cursor keys to position on the
  4313.          menu that you want to edit.  Then press <ENTER> to invoke the menu
  4314.          editor.
  4315.  
  4316.          In this window, you can use the following keys:
  4317.          ───────────────────────────────────────────────
  4318.  
  4319.            - Up/Down       Scroll up/down through existing menus.
  4320.            - Enter         Select an existing menu to edit.
  4321.            - Insert        Add a new menu.
  4322.  
  4323.          Once you have selected a menu, you will notice the name of the menu
  4324.          you are editing is displayed on the top line of the Menu Editor and
  4325.          a line-by-line list of the items on the selected menu is displayed.
  4326.  
  4327.          To add a menu item, press <Ins>, to remove a menu item, press
  4328.          <Del>.  Your menus can contain up to 255 menu items for each menu.
  4329.  
  4330.          To edit a menu item, move the selector to that item and
  4331.          press <Enter>.  You can change the menu prompt and highlight
  4332.          colors, or specify a RIP menu to be displayed to your users by
  4333.          pressing <Alt-P>.  If you want to see how a menu will look to
  4334.          your users (ASCII/ANSI), press <Alt-S>. You can also copy
  4335.          and paste menu items.  To copy an item, move to the item you want
  4336.          to copy, and press <Alt-C>. To insert the copied item somewhere
  4337.          else, move to the place where you want the menu item, and press
  4338.          <Ctrl-P>. You can even copy and paste items across different
  4339.          menus.
  4340.  
  4341.  
  4342.  
  4343.  
  4344.  
  4345.  
  4346.  
  4347.  
  4348.  
  4349.  
  4350.                                       - 77 -
  4351.  
  4352.  
  4353.  
  4354.          Hot Tip!
  4355.          ────────
  4356.          You can press <Alt-M> while logged on locally and a menu is
  4357.          displayed, or when a user is logged on and sitting on a menu.
  4358.          This launches the menu editor with the current menu loaded so you
  4359.          can edit it.  You will need to tell ProBoard which language
  4360.          you want the menu loaded for.  This makes it very easy to
  4361.          correct/add items to a menu you are viewing on the screen, while
  4362.          it is still fresh in your mind.
  4363.  
  4364.  
  4365.          Basically, each line of your menus that your users will see
  4366.          contains the following attributes.
  4367.  
  4368.          Text Line ................... Text line to be displayed to the
  4369.                                        user.
  4370.  
  4371.          Color ....................... Color of this menu item.  Press
  4372.                                        <ENTER> to edit the color for
  4373.                                        this menu item.
  4374.  
  4375.          HotKey ...................... The key the user is to press to
  4376.                                        activate this menu option.
  4377.  
  4378.          Function .................... Menu Function to be executed.  Press
  4379.                                        <ENTER> to display and select from a
  4380.                                        list of all ProBoard Menu Functions.
  4381.  
  4382.          Data ........................ Data associated with this menu item.
  4383.                                        Refer to the "Menu Functions"
  4384.                                        section of this chapter for more info
  4385.                                        on Data Items that you can use or
  4386.                                        that may be needed with some Menu
  4387.                                        Functions.
  4388.  
  4389.          Minimum Level ............... Minimum security level a user needs
  4390.                                        to access this menu item.
  4391.  
  4392.          Maximum Level ............... Maximum security level a user can
  4393.                                        have to access this menu item.
  4394.  
  4395.  
  4396.  
  4397.  
  4398.  
  4399.  
  4400.  
  4401.  
  4402.  
  4403.  
  4404.  
  4405.  
  4406.                                       - 78 -
  4407.  
  4408.  
  4409.  
  4410.          Flags ....................... The flags that the user needs in
  4411.                                        their user record to access this
  4412.                                        menu item.  Press <Enter> when on
  4413.                                        this field to invoke the menu flag
  4414.                                        editor.  Simply press the character
  4415.                                        (A-Z or 1-6) to toggle the flags.
  4416.                                        While you are in the menu flag
  4417.                                        editor you can press <F1> to
  4418.                                        view/modify notes about what
  4419.                                        your flags are used for.  You can
  4420.                                        also specify flags that a user MUST
  4421.                                        NOT have in order to access this
  4422.                                        menu item.  These flags are shown
  4423.                                        in reverse.  To set a reverse flag,
  4424.                                        press the flag letter twice (it will
  4425.                                        appear reversed).  To clear a
  4426.                                        reversed flag type the flag letter
  4427.                                        one more time.
  4428.  
  4429.          Minimum Age ................. The minimum age a user has to be in
  4430.                                        order to access this menu item.  Set
  4431.                                        this to "0" to disable age checking.
  4432.  
  4433.          Maximum Age ................. The oldest age that a user can be to
  4434.                                        access this menu option.
  4435.  
  4436.          Sex ......................... The sex the user must be to access
  4437.                                        this menu function.  Set this to
  4438.                                        "Don't Care" to allow users of
  4439.                                        either sex to use this menu option.
  4440.  
  4441.          Time Left ................... The minimum amount of time a user
  4442.                                        must have in order to use this menu
  4443.                                        function.  Great for doors that don't
  4444.                                        check a users remaining time, etc.
  4445.  
  4446.          Time Online ................. The amount of time a user must be
  4447.                                        online before they are allowed to
  4448.                                        select this menu option.
  4449.  
  4450.          Time Frame .................. The hours during which users can
  4451.                                        select this menu item.  Default is
  4452.                                        "fully enabled" meaning that this
  4453.                                        menu item is available at all times
  4454.                                        during a 24 hour period.  Press
  4455.                                        <Enter> to bring froward a window
  4456.                                        that will allow you to select times
  4457.                                        for this menu item to be accessed.
  4458.                                        Times are in 1/2 hour increments,
  4459.                                        based on a 24 hour format.
  4460.  
  4461.  
  4462.                                       - 79 -
  4463.  
  4464.  
  4465.  
  4466.          Minimum Speed ............... Minimum baud rate at which user must
  4467.                                        be connected in order to see this menu
  4468.                                        item.
  4469.  
  4470.          Maximum Speed ............... Maximum baud rate at which this menu
  4471.                                        item will be displayed.  Great for
  4472.                                        suggesting users with 300 baud modems
  4473.                                        buy a faster modem  :-)
  4474.  
  4475.          Nodes ....................... Determines on what nodes this menu
  4476.                                        item will be available.  Press
  4477.                                        [Enter] to change.
  4478.  
  4479.          Password required ........... If enabled, a password is required
  4480.                                        to execute this menu item (see next
  4481.                                        item)
  4482.  
  4483.          Password .................... Password required to executed this
  4484.                                        menu item (if enabled).  The
  4485.                                        password is not case sensitive.
  4486.  
  4487.  
  4488.          RIP Options
  4489.          ───────────
  4490.          Show Remote ................. If set to "Yes" then menu item or A??
  4491.                                        file will be sent to remote.  The
  4492.                                        default value for this setting is
  4493.                                        "No".
  4494.  
  4495.          Show Local .................. If set to "Yes", when the RIP
  4496.                                        sequence is sent to the user, the
  4497.                                        SysOp will see this as a normal ANSI
  4498.                                        menu-line or ANSI file.  The default
  4499.                                        value for this setting is "Yes"
  4500.  
  4501.          Reset Screen ................ If set to "Yes", ProBoard will reset
  4502.                                        (clear) the RIP windows before
  4503.                                        executing this menu function.
  4504.  
  4505.  
  4506.  
  4507.          ┌─────────────────────────────────────────────────────────────────┐
  4508.          │ Matrix Addresses (F10)                                          │
  4509.          └─────────────────────────────────────────────────────────────────┘
  4510.  
  4511.          This is where you enter your net address.  If you have more than
  4512.          one net address, enter them here also.
  4513.  
  4514.  
  4515.  
  4516.  
  4517.  
  4518.                                       - 80 -
  4519.  
  4520.  
  4521.  
  4522.          ┌─────────────────────────────────────────────────────────────────┐
  4523.          │ Modem Parameters - (Shift-F1)                                   │
  4524.          └─────────────────────────────────────────────────────────────────┘
  4525.  
  4526.          When selecting "Modem Parameters", you get a choice between the
  4527.          default configuration or a node-specific configuration.  The
  4528.          default configuration is used whenever there is no node-specific
  4529.          configuration defined.
  4530.  
  4531.          You do not need to change these parameters when using ProBoard
  4532.          with a front-end mailer, since it is in the mailer's setup where
  4533.          you would define your modem(s) parameters.
  4534.  
  4535.  
  4536.  
  4537.          Hardware Setup
  4538.          ──────────────
  4539.  
  4540.          COM port .................... Enter the port that your modem is
  4541.                                        configured to use.  For example,
  4542.                                        enter a 1 here to specify COM1, etc.
  4543.  
  4544.          Locked Speed ................ Set to "Yes" if your modem's bps
  4545.                                        rate is fixed (see below)
  4546.  
  4547.          Max. Bps Rate ............... Maximum baud rate your modem can
  4548.                                        handle.  If you are locking your
  4549.                                        COM port with the fossil driver,
  4550.                                        this setting is ignored.
  4551.  
  4552.          Modem Delay ................. Number of 1/10 seconds to pause
  4553.                                        between each character that is sent
  4554.                                        to the modem (some modems can't
  4555.                                        handle fast input).
  4556.  
  4557.          Answer Delay ................ Number of 1/10 seconds to wait
  4558.                                        before the answer command (see
  4559.                                        below) is sent to the modem after a
  4560.                                        ring is detected (only when "Manual
  4561.                                        Answer" is enabled)
  4562.  
  4563.  
  4564.  
  4565.  
  4566.  
  4567.  
  4568.  
  4569.  
  4570.  
  4571.  
  4572.  
  4573.  
  4574.                                       - 81 -
  4575.  
  4576.  
  4577.  
  4578.          Command Strings
  4579.          ───────────────
  4580.  
  4581.          You can insert special codes in the modem command strings:
  4582.  
  4583.              ^        Set DTR high.
  4584.              ` or v   Set DTR low.
  4585.              |        Sends a <CR> to the modem.
  4586.              $        Sends a break to the modem.
  4587.              ~        Pauses for 1/2 second.
  4588.  
  4589.  
  4590.          Make sure you add a '|' to send a return for all modem commands.
  4591.          The modem result messages also need a '|' if the modem sends a
  4592.          CR/LF after the message. (i.e. "ATA|" or "RING|")
  4593.  
  4594.  
  4595.          Init Command 1-3 ............ Modem initialization commmands.
  4596.                                        These are strings that have to be
  4597.                                        sent to the modem to initialize it
  4598.                                        and to have it ready to answer the
  4599.                                        phone.  It is possible to have up
  4600.                                        to 3 init commands.  The second one
  4601.                                        won't be sent until the first one
  4602.                                        results in "OK", and the third one
  4603.                                        won't be sent until the second one
  4604.                                        returns "OK".  Every 5 minutes, the
  4605.                                        modem will be re-initialized (some
  4606.                                        modems fall asleep after a while)
  4607.  
  4608.          Ok Message .................. What the modem sends back when a
  4609.                                        command was accepted ("OK")
  4610.  
  4611.          Off Hook Command ............ Command to be sent to the modem when
  4612.                                        the SysOp is logging in locally.
  4613.  
  4614.          Down Command ................ Command to be sent to the modem when
  4615.                                        the SysOp presses <Esc>
  4616.  
  4617.          Manual Answer ............... Set to "Yes" if ProBoard should send
  4618.                                        the answer command when a ring is
  4619.                                        received. Do NOT set your modem in
  4620.                                        auto-answer mode when using this
  4621.                                        option.
  4622.  
  4623.          Ring Message ................ What the modem sends when the phone
  4624.                                        rings.
  4625.  
  4626.          Answer Command .............. What ProBoard should send to answer
  4627.                                        the phone.
  4628.  
  4629.  
  4630.                                       - 82 -
  4631.  
  4632.  
  4633.  
  4634.          External/Fax Msg ............ ProBoard will exit immediately when
  4635.                                        this message is received from the
  4636.                                        modem.  This can be used to receive
  4637.                                        faxes when running ProBoard in a
  4638.                                        standalone environment (for some
  4639.                                        modems this string should be set to
  4640.                                        "CONNECT FAX").  ProBoard will then
  4641.                                        IMMEDIATELY exit with the given
  4642.                                        errorlevel.
  4643.  
  4644.          External Errorlevel ......... The errorlevel ProBoard will exit
  4645.                                        with when the above message is
  4646.                                        received from the modem.
  4647.  
  4648.  
  4649.          Connect Strings
  4650.          ───────────────
  4651.  
  4652.          <xxx> Bps Call .............. String returned by the modem upon an
  4653.                                        <xxx> bps call.  This is a 'partial'
  4654.                                        string. So if the modem sends
  4655.                                        'CONNECT 2400/ARQ', the string
  4656.                                        'CONNECT 2400' will match.  A '|'
  4657.                                        can be used to specify a CR/LF.  It
  4658.                                        HAS to be used for the 300 bps
  4659.                                        connect string, because "CONNECT"
  4660.                                        without a '|' would match "CONNECT
  4661.                                        2400" or "CONNECT 9600". So the
  4662.                                        correct string is: "CONNECT|".
  4663.  
  4664.          You can define up to 6 user-defined connect strings.  For each one
  4665.          you can specify the bps rate and the connect message that goes
  4666.          with it.
  4667.  
  4668.  
  4669.  
  4670.          LOCKING BAUD RATES
  4671.          ──────────────────
  4672.  
  4673.          Note: If you use an error-correcting modem (MNP/V42), you may have
  4674.          to lock your serial port speed using the fossil driver.
  4675.  
  4676.          A "locked" baud rate refers to the transfer rate between the
  4677.          computer and modem.  When locked, the baud rate will remain
  4678.          constant regardless of what the application program, such as
  4679.          ProBoard, requests the baud rate to be.  The modem MUST support
  4680.          a constant computer to modem speed, otherwise any baud rate change
  4681.          requested by an application will be ignored, resulting in an
  4682.          incorrect setting between your system and your users.  The result
  4683.          will be garbled input and output.
  4684.  
  4685.  
  4686.                                       - 83 -
  4687.  
  4688.  
  4689.  
  4690.          Most high speed modems do support a fixed baud rate, and by
  4691.          locking the baud rate you will obtain higher throughput.  A fossil
  4692.          program like X00 or BNU will handle this for you and is HIGHLY
  4693.          RECOMMENDED (see the respective fossil doc file for command
  4694.          syntax).
  4695.  
  4696.          Note:  Experience shows that a faster locking baud rate than actual
  4697.          phone line baud rate will yield the best results.
  4698.  
  4699.                 Examples:  X00 B,0,9600
  4700.                            BNU /L0=9600
  4701.  
  4702.           See your FOSSIL documentation for details.  If possible, install
  4703.           your fossil for "quiet" or "no commercial" mode so the screen
  4704.           display from the fossil does not bleed onto the ProBoard main
  4705.           screen (stand-alone systems with no mailers in particular).
  4706.  
  4707.  
  4708.  
  4709.          ┌─────────────────────────────────────────────────────────────────┐
  4710.          │ SysOp Macros (Shift-F2)                                         │
  4711.          └─────────────────────────────────────────────────────────────────┘
  4712.  
  4713.          There are 2 kinds of SysOp macros:
  4714.  
  4715.             - Key macros   : With this type of macro, it is possible to
  4716.                              assign many keystrokes to a single key.
  4717.                              When the macro key is pressed, all keys
  4718.                              specified will be passed to ProBoard, as if
  4719.                              you typed them yourself.
  4720.  
  4721.                              Special chars: '|' is replaced by <Enter>
  4722.                                             '^' is replaced by <Esc>
  4723.  
  4724.             - Shell macros : You can link any DOS command to a macro's hot-
  4725.                              key. A shell-definition MUST start with a '@'.
  4726.                              The string following the '@' should contain
  4727.                              the DOS command to be executed. You can,
  4728.                              of course, use the special shell options from
  4729.                              menu function 7.
  4730.  
  4731.                              Take this for an example:
  4732.  
  4733.                              Suppose you have set 'Swapping' to 'No' in
  4734.                              ProCFG. Should you, however, need ALL your
  4735.                              system memory in the shell, you could define
  4736.                              the following macro: @*C*N*Q*X (COMMAND.COM,
  4737.                              NoLog, NoMsg, Swapping).
  4738.  
  4739.  
  4740.  
  4741.  
  4742.                                       - 84 -
  4743.  
  4744.  
  4745.  
  4746.             - String macros: You can display a line of text to the user
  4747.                              with a hotkey. A string macro should start
  4748.                              with a back quote (`) character. When the
  4749.                              hotkey is pressed, the line of text will be
  4750.                              sent to the user and displayed on your local
  4751.                              screen.
  4752.  
  4753.  
  4754.  
  4755.          ┌─────────────────────────────────────────────────────────────────┐
  4756.          │ Events - (Shift-F3)                                             │
  4757.          └─────────────────────────────────────────────────────────────────┘
  4758.  
  4759.          It is possible to instruct ProBoard to perform some action at a
  4760.          set time and day (an "Event"). This action can be: exiting with
  4761.          a specific errorlevel (for a batch file) or executing a DOS
  4762.          command.  This is useful for example, to pack the user file, or to
  4763.          pack the message base at a specified time each day.
  4764.  
  4765.          You can define up to 30 events.
  4766.  
  4767.          An event is described by the following fields:
  4768.          ──────────────────────────────────────────────
  4769.  
  4770.          Enabled...................... If this is set to 'No', the event
  4771.                                        will be ignored.
  4772.  
  4773.          Active Days.................. Determines on what days of the week
  4774.                                        this event will run. To edit this
  4775.                                        field, press <Enter> and toggle
  4776.                                        the 'Yes/No' fields displayed next
  4777.                                        to each day.
  4778.  
  4779.          Event Time................... The time at which the event has to
  4780.                                        run on the selected days (in 24h
  4781.                                        format).
  4782.  
  4783.          Duration..................... How long this event has to stay
  4784.                                        active. During the event, no users
  4785.                                        are allowed to log in on ANY node.
  4786.  
  4787.  
  4788.  
  4789.  
  4790.  
  4791.  
  4792.  
  4793.  
  4794.  
  4795.  
  4796.  
  4797.  
  4798.                                       - 85 -
  4799.  
  4800.  
  4801.  
  4802.          Event type................... 'Command' : A DOS-command will be
  4803.                                                    executed when the event
  4804.                                                    is activated. You can
  4805.                                                    use any of the shell
  4806.                                                    options from menu type
  4807.                                                    7. Remember to use the
  4808.                                                    *Z option to run a batch
  4809.                                                    file.
  4810.  
  4811.                                        'Errlevel': When the event
  4812.                                                    is activated, ProBoard
  4813.                                                    will exit with an
  4814.                                                    errorlevel, specified in
  4815.                                                    the next field.
  4816.  
  4817.          Errorlevel................... The errorlevel to use for this event
  4818.                                        if the event type is set to
  4819.                                        'Errorlevel'.
  4820.  
  4821.          DOS-command.................. The DOS-command to execute for this
  4822.                                        event if the event type is set to
  4823.                                        'Command'.
  4824.  
  4825.          Node number.................. An event will run on ONE node. You
  4826.                                        can specify the node here.
  4827.  
  4828.  
  4829.          When using a frontend-mailer, you only have to specify the time,
  4830.          days and duration, because the events have to be executed by the
  4831.          mailer.
  4832.  
  4833.  
  4834.  
  4835.          ┌─────────────────────────────────────────────────────────────────┐
  4836.          │ Personal Files - (Shift-F4)                                     │
  4837.          └─────────────────────────────────────────────────────────────────┘
  4838.  
  4839.          ProBoard allows you and other users to send "Personal Files" to
  4840.          each other on the BBS.  ProBoard keeps track of each uploaded
  4841.          file.  You can add/edit/delete Personal Files with this option in
  4842.          ProCFG.  In the list of files, a [+] means that the file
  4843.          physically exists.  This assures you that a file you define as a
  4844.          Personal File for another user actually is in the directory
  4845.          waiting for them upon their next call to your BBS.  When the
  4846.          file name is shown between parentheses, it means that the file
  4847.          is not located in the personal files directory (as setup in
  4848.          ProCFG), but in another directory.
  4849.  
  4850.  
  4851.  
  4852.  
  4853.  
  4854.                                       - 86 -
  4855.  
  4856.  
  4857.  
  4858.          To edit an entry, press <Enter>, to Delete an entry, press <Del>,
  4859.          and to add an entry, press <Ins>.
  4860.  
  4861.          Filename..................... Name of the uploaded file.  Press
  4862.                                        <Alt-L> to select any file which is
  4863.                                        in your personal files directory.
  4864.                                        You can also enter a complete path
  4865.                                        and file name if the file you want
  4866.                                        to send is not located in the
  4867.                                        personal files directory. Keep in
  4868.                                        mind that when the "Delete" flag is
  4869.                                        set (see below), the file will be
  4870.                                        physically removed from your hard
  4871.                                        drive after the user has downloaded
  4872.                                        the file.
  4873.  
  4874.          From User.................... The user who sent this file. Press
  4875.                                        <Alt-L> to select a name from your
  4876.                                        user file, or type the name in
  4877.                                        yourself.
  4878.  
  4879.          To user...................... The destination user for this file.
  4880.                                        Press <Alt-L> to select a user from
  4881.                                        your user file, or type one in.
  4882.  
  4883.          Delete....................... If this flag is set to "Yes", the
  4884.                                        file will be physically deleted
  4885.                                        after the user has downloaded it.
  4886.                                        If set to "No", only the entry in
  4887.                                        the personal files list will be
  4888.                                        removed, not the file itself.
  4889.  
  4890.          It is possible to add files to this list.  This way you can send a
  4891.          file to a specific user.  ProBoard will handle deleting files after
  4892.          a user transfers "personal files" that are waiting for them (if
  4893.          the "Delete" flag is set).  You can also manually delete files in
  4894.          the "personal file" editor by positioning the highlight bar on the
  4895.          filename and pressing the <DEL> key.  You will be asked to confirm
  4896.          the deletion of the file before it is deleted from the "personal
  4897.          file" list as well as from your hard drive.
  4898.  
  4899.          For more information on how to implement this option on your BBS,
  4900.          refer to Menu Function(s) 22, 33, 32 explained in detail in the
  4901.          section on menus.
  4902.  
  4903.  
  4904.  
  4905.  
  4906.  
  4907.  
  4908.  
  4909.  
  4910.                                       - 87 -
  4911.  
  4912.  
  4913.  
  4914.          ┌─────────────────────────────────────────────────────────────────┐
  4915.          │ Language Editor - (Shift-F5)                                    │
  4916.          └─────────────────────────────────────────────────────────────────┘
  4917.  
  4918.          ProBoard allows you to change the text and the color for every
  4919.          prompt in the system to create a custom "look and feel" for your
  4920.          BBS.  ProBoard also allows you to display your system prompts to
  4921.          users in several different languages.
  4922.  
  4923.          Language files end with the file extension ".PBL" and are stored
  4924.          in your ProBoard system directory (usually C:\PB).  You can create
  4925.          and install up to 30 different language files at any one time.
  4926.  
  4927.          To create a different language file, first you must select one to
  4928.          work with as a model.  You then copy the model to a language file
  4929.          with a new name.  Refer to the following example:
  4930.  
  4931.                   COPY ENGLISH.PBL STARTREK.PBL
  4932.  
  4933.          This would create a new language file called "STARTREK.PBL" from
  4934.          the "ENGLISH.PBL" file (supplied with ProBoard).  All of the
  4935.          system prompts in "STARTREK.PBL" would at this point be exactly the
  4936.          same as the ones in ENGLISH.PBL.
  4937.  
  4938.          You should then start up PROCFG.EXE and select "Language Editor"
  4939.          (Shift+F5).  A window will be displayed showing the currently
  4940.          installed languages.  Position the highlight on STARTREK (notice
  4941.          that the name in the right column still says "English") and press
  4942.          <ENTER> to begin working with it.
  4943.  
  4944.          You will now see a full screen window with all of the prompts for
  4945.          your new STARTREK language file.  Note on the top line the
  4946.          following options:
  4947.  
  4948.          Alt-D ....................... Restores the default prompt for the
  4949.                                        system prompt you are currently
  4950.                                        positioned on.  So if you change the
  4951.                                        "Please enter your first and last
  4952.                                        name" prompt to read "Enter your
  4953.                                        name", and then decide you liked the
  4954.                                        default prompt better, press Alt-D
  4955.                                        while positioned on the "Enter your
  4956.                                        name" prompt and the default prompt
  4957.                                        will be restored.  The default prompt
  4958.                                        is always displayed on the bottom
  4959.                                        line of the Language Editor.
  4960.  
  4961.  
  4962.  
  4963.  
  4964.  
  4965.  
  4966.                                       - 88 -
  4967.  
  4968.  
  4969.  
  4970.          Alt-P ....................... Opens the "Language Properties"
  4971.                                        dialog.  This is where you define
  4972.                                        the properties for this language
  4973.                                        file.  You'll notice the description
  4974.                                        for the STARTREK language file still
  4975.                                        says ENGLISH in the description.
  4976.                                        This needs to be changed to STARTREK
  4977.                                        so your users can select the new
  4978.                                        language, otherwise they will have
  4979.                                        two ENGLISH languages to choose from.
  4980.  
  4981.          Alt-S ....................... Opens the "Search" dialog.  Enter a
  4982.                                        text string to search for in the
  4983.                                        language and ProBoard will move to
  4984.                                        the first prompt in the language file
  4985.                                        that matches.  To repeat the search,
  4986.                                        in the prompts for the next
  4987.                                        occurrence of the text string you
  4988.                                        entered, press <Alt-N>.  This allows
  4989.                                        you to easily search your entire
  4990.                                        language file for specified text,
  4991.                                        making changes to the prompts as the
  4992.                                        text is found.
  4993.  
  4994.          A description of the fields in the "Language Properties" dialog is
  4995.          as follows:
  4996.  
  4997.          Description ................. This is the name your users will see
  4998.                                        when choosing from language files
  4999.                                        they have access to.
  5000.  
  5001.          Available ................... Whether this language is available
  5002.                                        to callers with the proper security
  5003.                                        level.
  5004.  
  5005.          Level ....................... The minimum security level required
  5006.                                        to select this language file.
  5007.  
  5008.          Flags ....................... The security flags needed in a users
  5009.                                        record to be able to select this
  5010.                                        language file.
  5011.  
  5012.          Menu Path ................... The full path to your language
  5013.                                        specific menus.  If specified
  5014.                                        ProBoard will look for language
  5015.                                        specific menus in this path when
  5016.                                        users select this language.  If left
  5017.                                        blank, ProBoard will display the
  5018.                                        menus in the path specified in
  5019.                                        PROCFG, Options, Paths, Menus.
  5020.  
  5021.  
  5022.                                       - 89 -
  5023.  
  5024.  
  5025.  
  5026.          Text Path ................... The full path to your language
  5027.                                        specific text files.  If specified
  5028.                                        ProBoard will display language
  5029.                                        specific versions of your A?? text
  5030.                                        files if you create them.  RIP files
  5031.                                        need to be in one common directory
  5032.                                        (in other words, ProBoard does not
  5033.                                        support RIP language specific text
  5034.                                        files at this time.  If left blank,
  5035.                                        ProBoard will display the textfiles
  5036.                                        in the path specified in PROCFG,
  5037.                                        Options, Paths, Textfiles.
  5038.  
  5039.          Questionnaire Path .......... The full path to your language
  5040.                                        specific questionnaire files.  If
  5041.                                        specified ProBoard will use language
  5042.                                        specific versions of your
  5043.                                        questionnaires if you create them.
  5044.                                        If left blank, ProBoard will look for
  5045.                                        questionnaire files (files with the
  5046.                                        .Q-A file extension) in the ProBoard
  5047.                                        System Directory.
  5048.  
  5049.  
  5050.          Once you are positioned on a prompt that you want to change, press
  5051.          <ENTER> to invoke the "Edit Language String" dialog.  Each language
  5052.          string can be up to eight lines long.  The color for each string is
  5053.          fully configurable (just like in the menu editor).  You can insert
  5054.          the following control codes in your language string.
  5055.  
  5056.          @a<file>@ ................... Shows <file>.ANS/ASC/AVT (depending
  5057.                                        on the user's terminal setting).
  5058.                                        You can put this code anywhere in
  5059.                                        the prompt. (Example: "@aP_ENTER@"
  5060.                                        displays P_ENTER.A??)
  5061.  
  5062.          @p<file>@ ................... Runs <file>.PEX when this prompt
  5063.                                        is displayed.  Parameters are
  5064.                                        allowed (seperated by spaces).  You
  5065.                                        can put this control code anywhere
  5066.                                        in the prompt.
  5067.                                        (Example:  "@pTEST 2@" will run
  5068.                                        TEST.PEX with the parameter 2)
  5069.  
  5070.          ^ ........................... Toggles the highlight color on/off.
  5071.                                        The actual highlight color can be
  5072.                                        changed by selecting the "Highlight"
  5073.                                        option in the Language String
  5074.                                        editor.
  5075.  
  5076.  
  5077.  
  5078.                                       - 90 -
  5079.  
  5080.  
  5081.  
  5082.          \\ .......................... Single Backspace.
  5083.  
  5084.          \^ .......................... Generates a caret (the ^
  5085.                                        character).
  5086.  
  5087.           \<B><F> .................... Set background color to <B> and
  5088.                                        foreground color to <F>.  The color
  5089.                                        has to be entered as one hex
  5090.                                        character (0-9,A-F).
  5091.  
  5092.          The colors are:
  5093.          ───────────────
  5094.          0 - Black                     8 - Bright Black
  5095.          1 - Blue                      9 - Bright Blue
  5096.          2 - Green                     A - Bright Green
  5097.          3 - Cyan                      B - Bright Cyan
  5098.          4 - Red                       C - Bright Red
  5099.          5 - Magenta                   D - Bright Magenta
  5100.          6 - Yellow                    E - Bright Yellow
  5101.          7 - White (Grey)              F - Bright White (Grey)
  5102.  
  5103.          For the background color, bright colors are not available.  When
  5104.          you use 8-F for the background color, the color will have the
  5105.          blinking attribute.
  5106.  
  5107.  
  5108.          Other color codes you can use are:
  5109.          ──────────────────────────────────
  5110.          \HR    -> Bright red          \LR    -> Dark red
  5111.          \HG    -> Bright green        \LG    -> Dark green
  5112.          \HY    -> Bright yellow       \LY    -> Dark yellow
  5113.          \HB    -> Bright blue         \LB    -> Dark blue
  5114.          \HP    -> Bright purple       \LP    -> Dark purple
  5115.          \HC    -> Bright cyan         \LC    -> Dark cyan
  5116.          \HW    -> Bright white        \LW    -> Dark white
  5117.  
  5118.          Some examples:
  5119.          ──────────────
  5120.          \0F   Bright white on black
  5121.          \1B   Bright cyan on blue
  5122.          \8E   Bright yellow (blinking)
  5123.          \70   Reverse (black on grey)
  5124.          \LC   Dark cyan on black
  5125.  
  5126.  
  5127.  
  5128.  
  5129.  
  5130.  
  5131.  
  5132.  
  5133.  
  5134.                                       - 91 -
  5135.  
  5136.  
  5137.  
  5138.          A description of the fields in the Language String dialog is as
  5139.          follows:
  5140.  
  5141.          String #1 - String #8 ......  The actual text that will be
  5142.                                        displayed to your users.  Some
  5143.                                        prompts can be quite simple to
  5144.                                        understand (refer to Prompt #7)
  5145.                                        and some can seem quite difficult at
  5146.                                        first (refer to Prompt #207) with
  5147.                                        many options needing to be passed to
  5148.                                        the prompt, as well as hotkey values.
  5149.                                        A careful study of the default
  5150.                                        prompts, and how they display will
  5151.                                        help you to gain a better idea of how
  5152.                                        they work.
  5153.  
  5154.          Hotkeys ..................... The hotkeys needed for the prompt.
  5155.                                        If you study Prompt #207 you will see
  5156.                                        the hotkeys defined are "SCRDILAE".
  5157.                                        If you look at the text strings for
  5158.                                        this same prompt, you will see why
  5159.                                        these hotkeys are needed.  Be sure to
  5160.                                        specify the correct number and order
  5161.                                        of hotkeys for each prompt (if
  5162.                                        applicable).  Any prompt which does
  5163.                                        not use hotkeys will have "n/a"
  5164.                                        displayed in the hotkey field and
  5165.                                        you will not be able to enter
  5166.                                        anything into the hotkey field.
  5167.  
  5168.          Color ....................... Allows you to define a color for the
  5169.                                        prompt text displayed to your users.
  5170.                                        Press <ENTER> to select the color you
  5171.                                        want to use for your prompt text.
  5172.  
  5173.          Highlight ................... Allows you to define a color for the
  5174.                                        highlight.  Remember, highlight is
  5175.                                        toggled on/off with the ^ character.
  5176.  
  5177.          Prompt Color ................ Allows you to select a color for the
  5178.                                        users reply to this prompt.  For
  5179.                                        example, if your prompt reads "Enter
  5180.                                        your first AND last name" and this
  5181.                                        color is set to cyan, when a user
  5182.                                        types their name, what they type will
  5183.                                        be displayed in cyan (or whatever
  5184.                                        color you select here).
  5185.  
  5186.  
  5187.  
  5188.  
  5189.  
  5190.                                       - 92 -
  5191.  
  5192.  
  5193.  
  5194.          The Language Editor will allow you to see what your prompts will
  5195.          look like when a user sees them without showing you the control
  5196.          codes.  Move the highlight thru the language editor until you are
  5197.          close to, but not on, Prompt #191.  You will notice it displays
  5198.          "(DUPLICATE- DELETED") and the word "DELETED" is flashing.  Now
  5199.          move the highlight selector to prompt #191 and press <ENTER>.  You
  5200.          will now see the prompt with the control codes that make it flash,
  5201.          etc.
  5202.  
  5203.  
  5204.  
  5205.          ┌─────────────────────────────────────────────────────────────────┐
  5206.          │ Validate Template Editor - (Shift-F6)                           │
  5207.          └─────────────────────────────────────────────────────────────────┘
  5208.  
  5209.          ProBoard allows you to easily validate users on your BBS using the
  5210.          values defined here in the Validate Template Editor.
  5211.  
  5212.          The Validate Template Editor makes validation of your new users
  5213.          with any desired security level, loglevel, or combination of flag
  5214.          settings, and complete subscription support very easy.
  5215.  
  5216.          Once your templates have been defined, all you need to do to
  5217.          validate a user using the templates, is to press <ALT-V> while
  5218.          positioned on their record in the User Editor. Then, simply
  5219.          select which validation template you want to apply.
  5220.  
  5221.          Before you can use your validation templates, you must first
  5222.          define them.  This is done here, in the Validate Template Editor.
  5223.  
  5224.          To add a validation template, press <Alt-A>.  You can also press
  5225.          <F1> for help at any time while in the Validate Template Editor.
  5226.  
  5227.  
  5228.          The following keys can be used while in the Validate Template
  5229.          Editor.
  5230.  
  5231.          Page Up ..................... Go to the previous record in the
  5232.                                        template editor.
  5233.  
  5234.          Page Down ................... Go to the next record in the
  5235.                                        template editor.
  5236.  
  5237.          CTRL+PgUp.................... Go to first template record.
  5238.  
  5239.          CTRL+PgDn.................... Go to last template record.
  5240.  
  5241.          ESC ......................... Leave the template editor.
  5242.  
  5243.          Alt-A ....................... Add a template record.
  5244.  
  5245.  
  5246.                                       - 93 -
  5247.  
  5248.  
  5249.  
  5250.          Alt-D ....................... Toggles the current template record
  5251.                                        for deletion.
  5252.  
  5253.          Alt-F ....................... Show/Edit your flag descriptions.
  5254.  
  5255.          Alt-L ....................... Shows a list of all currently
  5256.                                        defined templates.
  5257.  
  5258.          Alt-S ....................... Searches currently defined templates
  5259.                                        by descriptions.
  5260.  
  5261.          Alt-N ....................... Searches for next record containing
  5262.                                        matching description as in previous
  5263.                                        search.
  5264.  
  5265.  
  5266.          The following fields make up a template "record" in ProBoard's
  5267.          Validate Template Editor.
  5268.  
  5269.  
  5270.          Description .................  This is the description for this
  5271.                                         template.  Be sure to describe your
  5272.                                         templates so you remember what
  5273.                                         security level they assign to a user
  5274.                                         at a later time when you validate
  5275.                                         them using the templates.
  5276.  
  5277.          Security Level .............. This is the security level you want
  5278.                                        assigned to a user when validating
  5279.                                        them using this template.
  5280.  
  5281.          Subscribe ................... How many days of "subscription"
  5282.                                        access a user will receive when
  5283.                                        validated using this template.
  5284.                                        ProBoard will use this value to
  5285.                                        calculate the Expiration Date in
  5286.                                        the users record.
  5287.  
  5288.          Expiration Level ............ The security level you want to assign
  5289.                                        when the users subscription level
  5290.                                        reaches the Expiration Date.
  5291.  
  5292.          Timebank Time ............... How many minutes of time you want to
  5293.                                        place into the users time bank account.
  5294.  
  5295.          Timebank Kbyte .............. How many KBytes of file credit you
  5296.                                        want to place into the users time
  5297.                                        bank account.
  5298.  
  5299.  
  5300.  
  5301.  
  5302.                                       - 94 -
  5303.  
  5304.  
  5305.  
  5306.          Netmail Credit .............. How many netmail credits the user
  5307.                                        should receive when validated.
  5308.  
  5309.          Validation Flags On ......... The flags to enable in a users record
  5310.                                        when validating them using this
  5311.                                        template.
  5312.  
  5313.          Validation Flags Off ........ The flags to disable in a users
  5314.                                        record when validating them using
  5315.                                        this template.
  5316.  
  5317.          Expiration Flags On ......... The flags to enable when a user
  5318.                                        reaches their expiration level.
  5319.  
  5320.  
  5321.          Expiration Flags Off ........ The flags to disable when a user
  5322.                                        reaches their expiration level.
  5323.  
  5324.          Comment ..................... A comment to place in the users
  5325.                                        record when validating them using
  5326.                                        this template.
  5327.  
  5328.          Loglevel .................... What loglevel to assign a user when
  5329.                                        validating them using this template.
  5330.                                        Use the <Space Bar> to cycle through
  5331.                                        the choices.
  5332.  
  5333.          Hidden ...................... If enabled, ProBoard will hide this
  5334.                                        users activity from the Last Callers
  5335.                                        list (Function 51), Show Users
  5336.                                        Online (Function 50), and from the
  5337.                                        display of the User List (Function
  5338.                                        13).
  5339.  
  5340.          No Tops ..................... If set to "Yes", then this user will
  5341.                                        be excluded from any of the "Tops"
  5342.                                        lists that ProBoard creates.  Refer
  5343.                                        to Menu Function 48 for more info.
  5344.  
  5345.          Attention ................... If set to "Yes", ProBoard will play
  5346.                                        the file ATTEN.MUS when this user
  5347.                                        logs on.  The file ATTEN.MUS must be
  5348.                                        in your ProBoard System Directory
  5349.                                        (usually C:\PB).
  5350.  
  5351.          NoKill ...................... If set to "Yes" the user's record
  5352.                                        CAN NOT be removed from the userfile
  5353.                                        when using PBUTIL UK (User Killer)
  5354.                                        or PBUTIL UP (User Packer).
  5355.  
  5356.  
  5357.  
  5358.                                       - 95 -
  5359.  
  5360.  
  5361.  
  5362.          Ignore Download ............. Does this user have UNLIMITED
  5363.                                        download access?  If set to "Yes",
  5364.                                        ProBoard will ignore download limits
  5365.                                        for this user.
  5366.  
  5367.          Deleted ..................... If this is set to "Yes", this means
  5368.                                        this Template Record is marked for
  5369.                                        deletion and will be cleared from
  5370.                                        your list of templates as soon as
  5371.                                        you leave the Validate Template
  5372.                                        Editor.
  5373.  
  5374.  
  5375.  
  5376.          ┌─────────────────────────────────────────────────────────────────┐
  5377.          │ About ProCFG - (Shift-F9)                                       │
  5378.          └─────────────────────────────────────────────────────────────────┘
  5379.  
  5380.          Displays a window which contains copyright information about
  5381.          ProCFG.
  5382.  
  5383.  
  5384.  
  5385.  
  5386.  
  5387.  
  5388.  
  5389.  
  5390.  
  5391.  
  5392.  
  5393.  
  5394.  
  5395.  
  5396.  
  5397.  
  5398.  
  5399.  
  5400.  
  5401.  
  5402.  
  5403.  
  5404.  
  5405.  
  5406.  
  5407.  
  5408.  
  5409.  
  5410.  
  5411.  
  5412.  
  5413.  
  5414.                                       - 96 -
  5415.  
  5416.  
  5417.  
  5418.          ╔═════════════════════════════════════════════════════════════════╗
  5419.          ╟─── SECURITY ────────────────────────────────────────────────────╢
  5420.          ╚═════════════════════════════════════════════════════════════════╝
  5421.  
  5422.  
  5423.          ┌─────────────────────────────────────────────────────────────────┐
  5424.          │ Levels & Flags                                                  │
  5425.          └─────────────────────────────────────────────────────────────────┘
  5426.  
  5427.          All security procedures toward a user are being done through the
  5428.          user's LEVEL and FLAGS. ProBoard can have levels ranging from 0 to
  5429.          64000, and provides 32 flags (A-Z, and 1-6) that can be ON or OFF.
  5430.  
  5431.          If a menu needs a certain level and flags, then only the users with
  5432.          a level equal to or higher than that level and with all the needed
  5433.          flags will be able to SEE and CHOOSE this menu option. It will
  5434.          remain invisible to all the other users.
  5435.  
  5436.          An example will be given in the next chapter.
  5437.  
  5438.  
  5439.  
  5440.          ┌─────────────────────────────────────────────────────────────────┐
  5441.          │ Trashcan                                                        │
  5442.          └─────────────────────────────────────────────────────────────────┘
  5443.  
  5444.          It is possible to specify names that cannot be used to log on to
  5445.          your system. Often used fake names are: "SysOp", "BBS", etc...
  5446.  
  5447.          You can specify these names in a textfile called TRASHCAN.CTL.
  5448.          Each line in this file specifies an unwanted or illegal name.
  5449.  
  5450.          An example file is included.
  5451.  
  5452.  
  5453.  
  5454.  
  5455.  
  5456.  
  5457.  
  5458.  
  5459.  
  5460.  
  5461.  
  5462.  
  5463.  
  5464.  
  5465.  
  5466.  
  5467.  
  5468.  
  5469.  
  5470.                                       - 97 -
  5471.  
  5472.  
  5473.  
  5474.          ╔═════════════════════════════════════════════════════════════════╗
  5475.          ╟─── MENUS ───────────────────────────────────────────────────────╢
  5476.          ╚═════════════════════════════════════════════════════════════════╝
  5477.  
  5478.  
  5479.          Menus are one of the most important parts of a BBS.  Menus are the
  5480.          direct interface between a user and your BBS. They are used to
  5481.          execute all the BBS functions, and they can have their own
  5482.          submenus.  They take care of security, by disabling or hiding
  5483.          certain functions from certain users or groups of users.
  5484.  
  5485.          ProBoard allows your BBS to have a very personal look, as your
  5486.          menus can be built and displayed in a VERY flexible way.
  5487.  
  5488.  
  5489.  
  5490.          ┌─────────────────────────────────────────────────────────────────┐
  5491.          │ Setting Up Menus                                                │
  5492.          └─────────────────────────────────────────────────────────────────┘
  5493.  
  5494.          A menu is basically line-oriented. Every line is linked to a
  5495.          function to be executed and to a textline to be shown to the user.
  5496.          Every line/function has its own level and flags, to make sure that
  5497.          not all of the menu items are available to every user.
  5498.  
  5499.  
  5500.          A menu line has the following fields:
  5501.          ─────────────────────────────────────
  5502.  
  5503.          Textline..................... Textline to be displayed to the user.
  5504.  
  5505.          Hotkey....................... Key to be pressed by the user to
  5506.                                        activate this menu item.
  5507.  
  5508.          Function..................... Function to be executed.
  5509.  
  5510.          Data......................... Data associated with this menu item.
  5511.  
  5512.          Level........................ Level needed to access this menu
  5513.                                        item.
  5514.  
  5515.          Flags........................ Flags needed to access this menu
  5516.                                        item.
  5517.  
  5518.          Color........................ Color of the menu line.
  5519.  
  5520.  
  5521.  
  5522.  
  5523.  
  5524.  
  5525.  
  5526.                                       - 98 -
  5527.  
  5528.  
  5529.  
  5530.          ┌─────────────────────────────────────────────────────────────────┐
  5531.          │ Menu Security                                                   │
  5532.          └─────────────────────────────────────────────────────────────────┘
  5533.  
  5534.          To clarify menu security, here's a simple example:
  5535.  
  5536.          Suppose we have 4 users with the following levels and flags:
  5537.  
  5538.             ┌──────────────────────┬───────┬─────────┐
  5539.             │  Name                │ Level │  Flags  │
  5540.             │----------------------│-------│---------│
  5541.             │ Pete                 │   10  │    Z    │
  5542.             │ Jerry                │  100  │    P    │
  5543.             │ Al                   │  100  │    R    │
  5544.             │ Charlie              │  200  │  P & R  │
  5545.             └──────────────────────┴───────┴─────────┘
  5546.  
  5547.          Let's define a menu with textlines only:
  5548.  
  5549.             ┌───────────────────────┬───────┬────────┐
  5550.             │ Text                  │ Level │ Flags  │
  5551.             │-----------------------│-------│--------│
  5552.             │ Good morning;         │   10  │        │
  5553.             │ ,;                    │   50  │        │
  5554.             │ Jerry                 │  100  │   P    │
  5555.             │ and;                  │  150  │        │
  5556.             │ Al;                   │  100  │   R    │
  5557.             │ send their best wishes│  200  │ P & R  │
  5558.             │ .                     │  300  │        │
  5559.             │ :-)                   │   10  │   X    │
  5560.             └───────────────────────┴───────┴────────┘
  5561.  
  5562.          This would give the following result when the menu is displayed:
  5563.  
  5564.             ┌─────────────────┬─────────────────────────────────┐
  5565.             │ Pete            │ Good morning                    │
  5566.             ╞═════════════════╪═════════════════════════════════╡
  5567.             │ Jerry           │ Good morning,Jerry              │
  5568.             ╞═════════════════╪═════════════════════════════════╡
  5569.             │ Al              │ Good morning,Al                 │
  5570.             ╞═════════════════╪═════════════════════════════════╡
  5571.             │ Charlie         │ Good morning, Jerry             │
  5572.             │                 │ and Al send their best wishes   │
  5573.             └─────────────────┴─────────────────────────────────┘
  5574.  
  5575.          The last 2 lines of the menu will NEVER be displayed, because none
  5576.          of the 4 users have the required level AND flags.
  5577.  
  5578.  
  5579.  
  5580.  
  5581.  
  5582.                                       - 99 -
  5583.  
  5584.  
  5585.  
  5586.          ┌─────────────────────────────────────────────────────────────────┐
  5587.          │ Creating Menus                                                  │
  5588.          └─────────────────────────────────────────────────────────────────┘
  5589.  
  5590.          Your BBS's main menu MUST! be stored in a file called TOP.PBM.
  5591.          All the other menus can have any file name you want to give them.
  5592.  
  5593.          When you select the 'Menu Editor' option in PROCFG's main menu, a
  5594.          new window will be opened containing the menus already available
  5595.          (if any).
  5596.  
  5597.          In this window, you can use the following keys:
  5598.  
  5599.            - Up/Down       Scroll up/down.
  5600.            - Enter         Select a menu.
  5601.            - Ins           Add a menu.
  5602.  
  5603.          When you have selected a menu, a list of all the menu items will
  5604.          be displayed. To add a menu item, just move past the last item and
  5605.          press <Enter>. To insert an item, press <Ins>, to remove one,
  5606.          press <Del>. To edit a menu item, move the selector to that item
  5607.          and press <Enter>. You can change the menu prompt and highlight
  5608.          colors by pressing <Alt-P>. If you want to see how a menu will
  5609.          look, press <Alt-S> to simulate what your users will see when they
  5610.          view this menu.
  5611.  
  5612.          You can also copy and paste menu items.
  5613.  
  5614.          To copy an item, move to the item you want to copy, and press
  5615.          <Alt-C>.  To insert the copied item somewhere else, move to the
  5616.          place where you want the menu item inserted, and press <Ctrl-P>.
  5617.          You can even copy and paste items across different menus.
  5618.  
  5619.  
  5620.  
  5621.  
  5622.  
  5623.  
  5624.  
  5625.  
  5626.  
  5627.  
  5628.  
  5629.  
  5630.  
  5631.  
  5632.  
  5633.  
  5634.  
  5635.  
  5636.  
  5637.  
  5638.                                       - 100 -
  5639.  
  5640.  
  5641.  
  5642.          A menu item has the following fields:
  5643.          ─────────────────────────────────────
  5644.  
  5645.          Textline..................... This is the string to be displayed.
  5646.                                        Leaving this field blank causes a
  5647.                                        blank line to be displayed to the
  5648.                                        user. A CR/LF will be sent after
  5649.                                        the menu line. To avoid this, just
  5650.                                        enter a ';' as the last character.
  5651.                                        This will cause the next textline
  5652.                                        of the menu to be appended to this
  5653.                                        one.
  5654.  
  5655.                                        Special textline characters:
  5656.  
  5657.                                           ^ : Switches between normal and
  5658.                                               highlighted color.
  5659.                                           ~ : Replaced by the number of
  5660.                                               minutes the user has left in
  5661.                                               this session.
  5662.                                           ` : Replaced by the name of the
  5663.                                               current message area (more
  5664.                                               about this later).
  5665.                                           @ : Replaced by the name of the
  5666.                                               current file area (more about
  5667.                                               this later).
  5668.  
  5669.                                        This textline can also contain text
  5670.                                        macros like @<NAME>@ or @<NODE>@.
  5671.                                        More about this in the "Text macros"
  5672.                                        section.
  5673.  
  5674.                                        You are not limited to two colors in
  5675.                                        menu lines. You can use the codes
  5676.                                        \1 to \7 to change colors, or \0 to
  5677.                                        return to the original color.
  5678.  
  5679.  
  5680.  
  5681.  
  5682.  
  5683.  
  5684.  
  5685.  
  5686.  
  5687.  
  5688.  
  5689.  
  5690.  
  5691.  
  5692.  
  5693.  
  5694.                                       - 101 -
  5695.  
  5696.  
  5697.  
  5698.          Hotkey....................... Most of the menu functions must be
  5699.                                        chosen by the user, so ProBoard must
  5700.                                        react to certain key-presses from
  5701.                                        the user. Receiving the hotkey for a
  5702.                                        certain menu item will cause
  5703.                                        ProBoard to execute the function
  5704.                                        associated with this item.
  5705.                                        The hotkey can be any ASCII
  5706.                                        character or digit,but one character
  5707.                                        has a special meaning to ProBoard:
  5708.                                        <Ctrl-A> will make this function
  5709.                                        AUTOEXEC, which means that
  5710.                                        this function will be executed as
  5711.                                        soon as this menu item is displayed
  5712.                                        (without really selecting this
  5713.                                        option).
  5714.  
  5715.          Function..................... The function associated with this
  5716.                                        menu item. Pressing the <Enter> key
  5717.                                        will cause a complete list of all
  5718.                                        the menu functions to be displayed
  5719.                                        in a separate window.
  5720.  
  5721.          Data......................... This field is optional with some of
  5722.                                        the functions. Basically, in this
  5723.                                        field you enter the parameters of a
  5724.                                        menu function. Eg. function 40
  5725.                                        (Display ASC/ANS file) needs a file-
  5726.                                        name as data (parameter). Function 1
  5727.                                        (Goto menu) needs the name of the
  5728.                                        menu to be jumped to. Text macros
  5729.                                        can be inserted (see "Text macros"
  5730.                                        section).
  5731.  
  5732.          Level........................ Level needed to access this menu
  5733.                                        item.
  5734.  
  5735.          Flags........................ Flags needed to access this menu
  5736.                                        item.
  5737.  
  5738.          Color........................ Color for the menu's textline to be
  5739.                                        displayed in.
  5740.  
  5741.  
  5742.  
  5743.  
  5744.  
  5745.  
  5746.  
  5747.  
  5748.  
  5749.  
  5750.                                       - 102 -
  5751.  
  5752.  
  5753.  
  5754.          ┌─────────────────────────────────────────────────────────────────┐
  5755.          │ Hints                                                           │
  5756.          └─────────────────────────────────────────────────────────────────┘
  5757.  
  5758.          You can create a menu by using textlines, but you can also create
  5759.          menus that display a file to the user, in which all the options
  5760.          are shown.  This technique works as follows:
  5761.  
  5762.          The first item in the menu should have ';' as textline and
  5763.          <Ctrl-A> (autoexec) as hotkey. The function to be executed should
  5764.          be function 40 (Display file with hotkeys).
  5765.  
  5766.          When the user accesses this menu, the specified file will
  5767.          immediately be sent. Setting all the remaining textlines of the
  5768.          menu to ';' will cause NOTHING BUT this file to be displayed.
  5769.  
  5770.          Combined with the use of text macros, this allows you to show
  5771.          different looking menus for each node you are running. For
  5772.          example, if you use function 40, and enter "MAIN@<NODE>@" in the
  5773.          data field, node 1 will see file MAIN1 , node 2 will see MAIN2,
  5774.          etc.
  5775.  
  5776.          This feature can be used to create a completely different set of
  5777.          menus for each node on your board!
  5778.  
  5779.          Another powerful feature is the ability to create a special menu
  5780.          called GLOBAL.PBM  This is the same as any other ProBoard menu
  5781.          except that all items defined in this menu will be appended to
  5782.          the bottom of each and every menu on your BBS.  This can help
  5783.          convey a standard look and feel for each of your menus to your
  5784.          users.  The prompt from the original menu and not from the
  5785.          GLOBAL.PBM is the prompt that will be displayed to your users.
  5786.          Be careful when using GLOBAL.PBM that you do not append hot-keys
  5787.          that are already in use on existing menus.
  5788.  
  5789.          If you need more information about all the possibilities, take a
  5790.          look at the example menus supplied with ProBoard.
  5791.  
  5792.  
  5793.  
  5794.  
  5795.  
  5796.  
  5797.  
  5798.  
  5799.  
  5800.  
  5801.  
  5802.  
  5803.  
  5804.  
  5805.  
  5806.                                       - 103 -
  5807.  
  5808.  
  5809.  
  5810.          ┌─────────────────────────────────────────────────────────────────┐
  5811.          │ Menu Function Summary                                           │
  5812.          └─────────────────────────────────────────────────────────────────┘
  5813.  
  5814.          The following is a summary list of the ProBoard Menu Functions.
  5815.  
  5816.          Each Menu Function is explained in detail in the following section
  5817.          titled "Menu Functions Overview".
  5818.  
  5819.          Function        Action Performed                             Page
  5820.          ───────────     ──────────────────────────────────────────   ────
  5821.  
  5822.          Function 1 .... GOTO Menu ................................   106
  5823.          Function 2 .... GOSUB Menu ...............................   107
  5824.          Function 3 .... GOTO Previous Menu .......................   108
  5825.          Function 4 .... GOTO Menu and Clear Menu Stack ...........   108
  5826.          Function 5 .... Show ANS/ASC File.........................   109
  5827.          Function 6 .... Change State .............................   109
  5828.          Function 7 .... Shell ....................................   110
  5829.          Function 8 .... Show Version Information .................   113
  5830.          Function 9 .... Log Off ..................................   113
  5831.          Function 10 ... Show System Usage Per Hour (Graph) .......   113
  5832.          Function 11 ... Chat Request .............................   114
  5833.          Function 12 ... Execute Questionnaire Script .............   114
  5834.          Function 13 ... Display User List ........................   118
  5835.          Function 14 ... Display Time Info ........................   118
  5836.          Function 15 ... Show A?? File and Wait ...................   118
  5837.          Function 16 ... Change City ..............................   118
  5838.          Function 17 ... Change Password ..........................   119
  5839.          Function 18 ... Change Screen Length .....................   119
  5840.          Function 19 ... Toggle Screen Clearing Codes .............   119
  5841.          Function 20 ... Toggle More Prompt .......................   120
  5842.          Function 21 ... Toggle ANSI Codes ........................   121
  5843.          Function 22 ... Check for Personal Mail / Files ..........   122
  5844.          Function 23 ... Read Messages ............................   122
  5845.          Function 24 ... Scan Messages ............................   124
  5846.          Function 25 ... Quick Scan Messages ......................   124
  5847.          Function 26 ... Show System Usage by Day (Graph) .........   124
  5848.          Function 27 ... Write a Message ..........................   124
  5849.          Function 28 ... Combined Boards Select ...................   126
  5850.          Function 29 ... Display System Usage Per Week (Graph).....   126
  5851.          Function 30 ... Show Directory ...........................   126
  5852.          Function 31 ... List Files ...............................   127
  5853.          Function 32 ... Download a File ..........................   129
  5854.          Function 33 ... Upload a File ............................   132
  5855.          Function 34 ... View an Archive ..........................   133
  5856.          Function 35 ... File Search by Keyword ...................   133
  5857.  
  5858.  
  5859.  
  5860.  
  5861.  
  5862.                                       - 104 -
  5863.  
  5864.  
  5865.  
  5866.          Function        Action Performed                             Page
  5867.          ───────────     ──────────────────────────────────────────   ────
  5868.  
  5869.          Function 36 ... File Search by File Name .................   134
  5870.          Function 37 ... Show New Files ...........................   134
  5871.          Function 38 ... View a File ..............................   134
  5872.          Function 39 ... Display Named File .......................   135
  5873.          Function 40 ... Display A?? File with Menu Hotkeys .......   135
  5874.          Function 41 ... Toggle the Full Screen Editor ............   136
  5875.          Function 42 ... Toggle Command Stacking/Hotkeys ..........   136
  5876.          Function 43 ... Clear Marked Messages ....................   137
  5877.          Function 44 ... Global Combined Boards Selection .........   137
  5878.          Function 45 ... Display Text File and Wait ...............   137
  5879.          Function 46 ... Change User Level and/or Flags ...........   137
  5880.          Function 47 ... Make a Log Entry .........................   138
  5881.          Function 48 ... Show Hit Parade ..........................   138
  5882.          Function 49 ... Select Message Area ......................   139
  5883.          Function 50 ... Show Users Online ........................   140
  5884.          Function 51 ... List Last Callers ........................   140
  5885.          Function 52 ... Remote User Editor .......................   141
  5886.          Function 53 ... Multi-Line (Internode) Chat ..............   141
  5887.          Function 54 ... Select File Area .........................   142
  5888.          Function 55 ... Show .GIF File Information ...............   142
  5889.          Function 56 ... Toggle IBM Characters ....................   142
  5890.          Function 57 ... Change Phone Number ......................   143
  5891.          Function 58 ... Change Data/Fax Phone Number .............   143
  5892.          Function 59 ... Change User Alias (Handle) ...............   143
  5893.          Function 60 ... Run ProBoard SDK File ....................   144
  5894.          Function 61 ... Bulletin Menu ............................   144
  5895.          Function 62 ... Toggle AVATAR/0 ..........................   145
  5896.          Function 63 ... Toggle AVATAR/0+ .........................   146
  5897.          Function 64 ... Show Graph (General) .....................   146
  5898.          Function 65 ... Display A??/RIP file with Hotkeys ........   147
  5899.          Function 66 ... Change RIPscrip Font .....................   147
  5900.          Function 67 ... Toggle RIPscrip Graphics .................   148
  5901.          Function 68 ... Edit Tagged Files ........................   148
  5902.          Function 69 ... Select a new Language ....................   148
  5903.          Function 70 ... Change Date Format .......................   149
  5904.          Function 71 ... Change Mailing Address ...................   149
  5905.          Function 72 ... Change FAX Number ........................   149
  5906.          Function 73 ... Change Country ...........................   149
  5907.          Function 74 ... Change Default Protocol ..................   150
  5908.          Function 75 ... Select Message Area Group ................   150
  5909.          Function 76 ... Select File Area Group ...................   150
  5910.  
  5911.  
  5912.  
  5913.  
  5914.  
  5915.  
  5916.  
  5917.  
  5918.                                       - 105 -
  5919.  
  5920.  
  5921.  
  5922.          ┌─────────────────────────────────────────────────────────────────┐
  5923.          │ Menu Functions Overview                                         │
  5924.          └─────────────────────────────────────────────────────────────────┘
  5925.  
  5926.          In this function overview, parameters between <> are REQUIRED,
  5927.          and parameters between [] are optional.
  5928.  
  5929.               For example:  <blank> is a required parameter.
  5930.                             [/M] is an option you might specify in addition.
  5931.  
  5932.  
  5933.  
  5934.          ┌─────────────────────────────────────────────────────────────────┐
  5935.          │ Function 1: GOTO MENU                                           │
  5936.          └─────────────────────────────────────────────────────────────────┘
  5937.  
  5938.          DATA: <menu name> [/M=<nr msgarea>] [/F=<nr filearea>] [/P=<pwd>]
  5939.  
  5940.  
  5941.          This function makes ProBoard jump to menu <menu name>.
  5942.  
  5943.          Option /M can be used to define one single menu for several
  5944.          message areas. You could jump to a 'general' message area menu and
  5945.          pass option /M=3, to make message area 3 active for the selected
  5946.          menu. Please refer to function 23 (Read messages) for more
  5947.          information about this option.
  5948.  
  5949.          Option /F works exactly the same, but applies to file areas.
  5950.  
  5951.          It is possible to protect a menu with a password by using the /P=
  5952.          option. For example: "SysOp /P=Test" would protect menu "SysOp"
  5953.          with the password "Test". The user will have to enter this
  5954.          password to be allowed to move to the menu.
  5955.  
  5956.          It is also possible to select the next available message or file
  5957.          areas with the use of the following parameters.
  5958.  
  5959.            /M=+   (set next accessible Message Area)
  5960.            /M=-   (set previous accessible Message Area)
  5961.            /F=+   (set next available File Area)
  5962.            /F=-   (set previous accessible File Area)
  5963.  
  5964.          Data examples:
  5965.  
  5966.            MSG /M=5
  5967.            ────────
  5968.            This makes ProBoard GOTO the menu named "MSG" and sets the
  5969.            Message Area to Area #5.
  5970.  
  5971.  
  5972.  
  5973.  
  5974.                                       - 106 -
  5975.  
  5976.  
  5977.  
  5978.            FILE /F=10
  5979.            ──────────
  5980.            This makes ProBoard display the menu named "FILE" and sets the
  5981.            File Area to Area #10
  5982.  
  5983.            MSG /M=+
  5984.            ────────
  5985.            This makes ProBoard display the menu named "MSG" and selects the
  5986.            next Message Area that is available to this caller.
  5987.  
  5988.            FILE /F=-
  5989.            ─────────
  5990.            This makes ProBoard display the menu named "FILE" and selects the
  5991.            previous File Area that is available to this caller.
  5992.  
  5993.  
  5994.  
  5995.          ┌─────────────────────────────────────────────────────────────────┐
  5996.          │ Function 2: GOSUB MENU                                          │
  5997.          └─────────────────────────────────────────────────────────────────┘
  5998.  
  5999.          DATA: <menu name> [/M=<nr msgarea>] [/F=<nr filearea>] [/P=pwd]
  6000.  
  6001.  
  6002.          This function is largely the same as the Menu Function 1 (it
  6003.          even has the same parameters), but the menu this function is
  6004.          called from is pushed onto an internal stack. ProBoard will jump
  6005.          back to this menu when returning from menu <menu name> (by
  6006.          executing Menu Function 3).
  6007.  
  6008.          Data examples:  (see Menu Function 1 for complete parameters)
  6009.  
  6010.            MSG /M=5
  6011.            ────────
  6012.            This makes ProBoard display the menu named "MSG" and sets the
  6013.            Message Area to Area #5.  It also places the previous menu on
  6014.            a stack.  The previous menu can be returned to by using Menu
  6015.            Function 3.
  6016.  
  6017.            FILE /F=10
  6018.            ──────────
  6019.            This makes ProBoard display the menu named "FILE" and sets the
  6020.            File Area to Area #10.  It also places the previous menu on
  6021.            a stack.  The previous menu can be returned to by using Menu
  6022.            Function 3.
  6023.  
  6024.  
  6025.  
  6026.  
  6027.  
  6028.  
  6029.  
  6030.                                       - 107 -
  6031.  
  6032.  
  6033.  
  6034.            MSG /M=+
  6035.            ────────
  6036.            This makes ProBoard display the menu named "MSG" and selects the
  6037.            next Message Area that is available to this caller.  It also
  6038.            places the previous menu on a stack.  The previous menu can be
  6039.            returned to by using Menu Function 3.
  6040.  
  6041.            FILE /F=-
  6042.            ─────────
  6043.            This makes ProBoard display the menu named "FILE" and selects
  6044.            the previous File Area that is available to this caller.  It
  6045.            also places the previous menu on a stack.  The previous menu
  6046.            can be returned to by using Menu Function 3.
  6047.  
  6048.  
  6049.  
  6050.          ┌─────────────────────────────────────────────────────────────────┐
  6051.          │ Function 3: GOTO PREVIOUS MENU                                  │
  6052.          └─────────────────────────────────────────────────────────────────┘
  6053.  
  6054.          DATA: -
  6055.  
  6056.  
  6057.          This function makes ProBoard go back to the previous menu if you
  6058.          used Menu Function 2.
  6059.  
  6060.  
  6061.  
  6062.          ┌─────────────────────────────────────────────────────────────────┐
  6063.          │ Function 4: GOTO MENU & CLEAR STACK                             │
  6064.          └─────────────────────────────────────────────────────────────────┘
  6065.  
  6066.          DATA: <menu name> [/M=<nr msgarea>] [/F=<nr filearea>] [/P=pwd]
  6067.  
  6068.  
  6069.          This function performs the same tasks as Menu Function 1, but will
  6070.          clear the existing menu stack, thus preventing the user from
  6071.          returning to the previous menu.
  6072.  
  6073.          Data examples:  (see Menu Function 1 for complete parameters)
  6074.  
  6075.            MSG /M=5
  6076.            ────────
  6077.            This makes ProBoard display the menu named "MSG" and sets the
  6078.            Message Area to Area #5.  The menu stack will be cleared
  6079.            preventing return to any previous menus already on the stack.
  6080.  
  6081.  
  6082.  
  6083.  
  6084.  
  6085.  
  6086.                                       - 108 -
  6087.  
  6088.  
  6089.  
  6090.            FILE /F=10
  6091.            ──────────
  6092.            This makes ProBoard display the menu named "FILE" and sets the
  6093.            File Area to Area #10.  The menu stack will be cleared
  6094.            preventing return to any previous menus already on the stack.
  6095.  
  6096.            MSG /M=+
  6097.            ────────
  6098.            This makes ProBoard display the menu named "MSG" and selects the
  6099.            next Message Area that is available to this caller.  The menu
  6100.            stack will be cleared preventing return to any previous menus
  6101.            already on the stack.
  6102.  
  6103.            FILE /F=-
  6104.            ─────────
  6105.            This makes ProBoard display the menu named "FILE" and selects
  6106.            the previous File Area that is available to this caller.  The
  6107.            stack will be cleared preventing return to any previous menus
  6108.            already on the stack.
  6109.  
  6110.  
  6111.  
  6112.          ┌─────────────────────────────────────────────────────────────────┐
  6113.          │ Function 5: SHOW ANS/ASC FILE                                   │
  6114.          └─────────────────────────────────────────────────────────────────┘
  6115.  
  6116.          DATA: <filename>
  6117.  
  6118.  
  6119.          This function displays a file to the user with the extension .ANS
  6120.          or .ASC, depending on the user's ANSI-setting. The file must be
  6121.          stored in ProBoard's textfiles directory; <filename> should NOT
  6122.          contain an extension (max. eight characters). If ProBoard doesn't
  6123.          find the .ANS file, it will look for the .ASC file.
  6124.  
  6125.  
  6126.  
  6127.          ┌─────────────────────────────────────────────────────────────────┐
  6128.          │ Function 6: CHANGE STATE                                        │
  6129.          └─────────────────────────────────────────────────────────────────┘
  6130.  
  6131.          DATA: -
  6132.  
  6133.  
  6134.          Allows a user to change the state in their user-record.
  6135.  
  6136.  
  6137.  
  6138.  
  6139.  
  6140.  
  6141.  
  6142.                                       - 109 -
  6143.  
  6144.  
  6145.  
  6146.          ┌─────────────────────────────────────────────────────────────────┐
  6147.          │ Function 7: SHELL                                               │
  6148.          └─────────────────────────────────────────────────────────────────┘
  6149.  
  6150.          DATA: <command line>
  6151.  
  6152.  
  6153.          With this function, you can instruct ProBoard to execute an
  6154.          external program. This program has to do its own serial I/O, so
  6155.          ordinary programs will only work if run locally.
  6156.  
  6157.          Parameter <command line> needs full path and filename (.COM or
  6158.          .EXE extension included), and may contain some special codes.
  6159.          These codes will (at run-time) be replaced by a value or a string.
  6160.  
  6161.          Special codes:
  6162.  
  6163.              **      Replaced by an asterisk ('*')
  6164.  
  6165.              *#      Replaced by the node number.
  6166.  
  6167.              *\      Sends the message "SysOp is shelling..." to the user
  6168.                      before the shell is executed, and the message "SysOp
  6169.                      has returned..." afterwards.
  6170.  
  6171.              *!      Freezes ProBoard's system timer when shelling.
  6172.  
  6173.              *=      Do not call any fossil functions when shelling.  Great
  6174.                      for use in INIT.PEX files.
  6175.  
  6176.              *A      Writes a user's handle (alias) to DORINFOx.DEF instead
  6177.                      of his/her real name.
  6178.  
  6179.              *B      Current baud rate.
  6180.  
  6181.              *C      Replaced by the full name & path of the command
  6182.                      interpreter. It is the contents of the environment
  6183.                      variable "COMSPEC". This usually is C:\COMMAND.COM.
  6184.  
  6185.              *D      Writes a full 52-line DOOR.SYS drop file to the current
  6186.                      directory before shelling.
  6187.  
  6188.              *E      Writes an RA 1.1x EXITINFO.BBS to the current directory
  6189.                      before shelling and reads it back afterwards.  ProBoard
  6190.                      creates an RA 2.xx by default so if you need the older
  6191.                      EXITINFO.BBS format be sure to specify the *E
  6192.                      parameter.
  6193.  
  6194.              *F      User's first name.
  6195.  
  6196.  
  6197.  
  6198.                                       - 110 -
  6199.  
  6200.  
  6201.  
  6202.              *G      Indicates whether user has ANSI (1) or ASCII (0) set.
  6203.  
  6204.              *H      Tells ProBoard not to disable the fossil driver when
  6205.                      shelling.
  6206.  
  6207.              *I      Maximum user-inactivity (seconds).
  6208.  
  6209.              *L      User's last name.
  6210.  
  6211.              *M      ProBoard's start-up directory (including trailing '\')
  6212.  
  6213.              *N      Shell will NOT be logged in PROBOARD.LOG.
  6214.  
  6215.              *O      (not zero!) is replaced by the path of the current
  6216.                      file area.
  6217.  
  6218.              *P      Com-port used by ProBoard (1-8).
  6219.  
  6220.              *Q      Don't let user know that ProBoard is shelling (!).
  6221.  
  6222.              *R      User's record number in USERS.BBS.
  6223.  
  6224.              *S      ProBoard's system directory (incl. trailing '\')
  6225.  
  6226.              *T      Time left for the user today (minutes).
  6227.  
  6228.              *V      Disables adding 2 to the graphics capability line in
  6229.                      DORINFOx.DEF when the user has AVATAR enabled.
  6230.  
  6231.              *W      Runs the shell in a window , so the status on the last
  6232.                      line will not be cleared. This option only works with
  6233.                      programs that send their output to the standard output
  6234.                      device (no direct screen writes).
  6235.  
  6236.              *X      ALWAYS SWAP to disk/EMS, even if swapping is disabled
  6237.                      in ProCFG.
  6238.  
  6239.              *Y      DO NOT SWAP to disk/EMS.
  6240.  
  6241.              *Z      Execute the command as if you typed it from the
  6242.                      command line. The main use for this option is to
  6243.                      execute DOS batch files. It is exactly the same as
  6244.                      entering "*C /C <command>". It can also be useful to
  6245.                      execute programs that are located in your path,
  6246.                      without having to specify the exact directory name.
  6247.  
  6248.  
  6249.  
  6250.  
  6251.  
  6252.  
  6253.  
  6254.                                       - 111 -
  6255.  
  6256.  
  6257.  
  6258.              *_      (asterisk underscore) Tells ProBoard not to write
  6259.                      underscores instead of spaces when writing a user's
  6260.                      last name in DORINFOx.DEF. For example, users name is
  6261.                      Harvey Van Hooten.  Without this parameter, users name
  6262.                      will be written to DORINFOx.DEF as follows:
  6263.  
  6264.                        HARVEY VAN_HOOTEN
  6265.  
  6266.                      By using the *_ (asterisk underscore) the users name
  6267.                      will be written to DORINFOx.DEF as follows:
  6268.  
  6269.                        HARVEY VAN HOOTEN (with no underscore in last name)
  6270.  
  6271.              *0      (zero) ProBoard will write a DORINFO1.DEF instead of a
  6272.                      DORINFO<node>.DEF - great for running doors which
  6273.                      require a DORINFO1.DEF file on a multi node ProBoard
  6274.                      system.
  6275.  
  6276.              *1      Installs a timer-function when shelling, which
  6277.                      continuously redisplays the user's status line on the
  6278.                      first screenline. This can be used with ALL programs.
  6279.                      (Works great most full-screen protocols!)
  6280.  
  6281.              *2      Same as *1, but uses the bottom screenline (try this
  6282.                      with QuickEd or GEdit!)
  6283.  
  6284.  
  6285.          Suppose ProBoard is in directory D:\PB.
  6286.  
  6287.          Data example: *Q*STEST.EXE *B
  6288.  
  6289.          ProBoard will execute D:\PB\TEST.EXE 2400 and the user won't see
  6290.          this happening.
  6291.  
  6292.          To execute a batch file, you have to use the following syntax:
  6293.          "*Z<filename>.BAT <parameters>". This is expanded to:
  6294.          "*C /C <filename>.BAT <parameters>".
  6295.  
  6296.          When shelling, ProBoard writes a standard DORINFOx.DEF file, where
  6297.          x stands for the node-number. An RA-compatible EXITINFO.BBS file
  6298.          and a DOORWAY-compatible DOOR.SYS can also be created by
  6299.          specifying the *E and/or *D options. All these files are created
  6300.          in the directory where ProBoard is started from.
  6301.  
  6302.  
  6303.  
  6304.  
  6305.  
  6306.  
  6307.  
  6308.  
  6309.  
  6310.                                       - 112 -
  6311.  
  6312.  
  6313.  
  6314.          ┌─────────────────────────────────────────────────────────────────┐
  6315.          │ Function 8: SHOW VERSION INFORMATION                            │
  6316.          └─────────────────────────────────────────────────────────────────┘
  6317.  
  6318.          DATA: -
  6319.  
  6320.  
  6321.          This function shows information about ProBoard's version number.
  6322.          If you have a registered copy of ProBoard, the SysOp's name and
  6323.          BBS-name will be shown. With this function, you can show off to
  6324.          your users that you're a nice SysOp: one that registered!
  6325.  
  6326.  
  6327.  
  6328.          ┌─────────────────────────────────────────────────────────────────┐
  6329.          │ Function 9: LOGOFF                                              │
  6330.          └─────────────────────────────────────────────────────────────────┘
  6331.  
  6332.          DATA: -
  6333.  
  6334.  
  6335.          Shows the file GOODBYE.ANS/ASC and hangs up the phone.
  6336.  
  6337.  
  6338.  
  6339.          ┌─────────────────────────────────────────────────────────────────┐
  6340.          │ Function 10: SHOW SYSTEM USAGE PER HOUR (GRAPH)                 │
  6341.          └─────────────────────────────────────────────────────────────────┘
  6342.  
  6343.          DATA: -
  6344.  
  6345.  
  6346.          Shows a bar graph of the average system usage per hour. From the
  6347.          day you install ProBoard, it will keep track of a usage rate per
  6348.          hour and per day. If you want to change the usage values, just
  6349.          edit the values using ProCFG.
  6350.  
  6351.  
  6352.  
  6353.  
  6354.  
  6355.  
  6356.  
  6357.  
  6358.  
  6359.  
  6360.  
  6361.  
  6362.  
  6363.  
  6364.  
  6365.  
  6366.                                       - 113 -
  6367.  
  6368.  
  6369.  
  6370.          ┌─────────────────────────────────────────────────────────────────┐
  6371.          │ Function 11: CHAT REQUEST                                       │
  6372.          └─────────────────────────────────────────────────────────────────┘
  6373.  
  6374.          DATA: -
  6375.  
  6376.  
  6377.          This function allows the user to make a request to chat with the
  6378.          SysOp. The user will be prompted for a reason why he wants to
  6379.          chat. The minimal length of this reason must be 5 characters.
  6380.          ProBoard will not allow the user to enter 5 spaces as a reason for
  6381.          chatting.  If the SysOp does not answer, the status line will start
  6382.          flashing, indicating that the users wants to chat. You can view the
  6383.          reason for the chat by pressing <F8>.
  6384.  
  6385.          You can define your own page-tune by creating a RemoteAccess-
  6386.          compatible description file. The format of this file is described
  6387.          in the reference section.
  6388.  
  6389.  
  6390.  
  6391.          ┌─────────────────────────────────────────────────────────────────┐
  6392.          │ Function 12: EXECUTE QUESTIONNAIRE SCRIPT                       │
  6393.          └─────────────────────────────────────────────────────────────────┘
  6394.  
  6395.          DATA: <scriptname>
  6396.  
  6397.  
  6398.          This function executes a questionnaire. A questionnaire is a
  6399.          common ASCII-file containing several commands to be executed by
  6400.          ProBoard. A questionnaire scriptfile has an extension .Q-A, and
  6401.          the user's answers will be stored in a file with the same
  6402.          filename, but with extension .ASW.
  6403.          Starting from version 1.15, you can write very powerful
  6404.          questionnaires by using the ProBoard SDK.
  6405.  
  6406.          You can use the following commands in a scriptfile:
  6407.  
  6408.  
  6409.          ASK <length> <number of variable>
  6410.  
  6411.               eg: Ask 10 1
  6412.  
  6413.          Asks the user something. The user has <length> characters to
  6414.          answer, and the answer will be stored in the variable <number
  6415.          of variable>. The maximum number of variables in ProBoard is 20.
  6416.  
  6417.  
  6418.  
  6419.  
  6420.  
  6421.  
  6422.                                       - 114 -
  6423.  
  6424.  
  6425.  
  6426.          CHANGECOLOR <color>
  6427.  
  6428.               eg: ChangeColor 3
  6429.  
  6430.          Changes the color in which the following text will be displayed.
  6431.          The number <color> is the ANSI color code, which means that this
  6432.          function works only for users who use ANSI.
  6433.  
  6434.  
  6435.  
  6436.          CLEARSCREEN
  6437.  
  6438.          Well, what do you think?
  6439.  
  6440.  
  6441.  
  6442.          DISPLAY "<string>"
  6443.  
  6444.               eg: Display "Hi there!"
  6445.  
  6446.          Displays a string <string>. The string must be contained in double
  6447.          quotes; a '|' in a string will be replaced by CR/LF (new line).
  6448.  
  6449.  
  6450.          IF <number of variable> = "<string>"
  6451.  
  6452.                 eg. If 1 = "Y"
  6453.  
  6454.          Directs the .Q-A file according to the user's answers.
  6455.          If the condition is met, all commands after the IF-statement will
  6456.          be executed, until an ENDIF is encountered.
  6457.  
  6458.  
  6459.  
  6460.          ENDIF
  6461.  
  6462.          Ends an IF-statement.
  6463.  
  6464.               eg: Display "Do you have a hard disk?"
  6465.                   GetChoice YN 1
  6466.                   If 1 = "Y"
  6467.                     Display "Storage space in Mb?"
  6468.                     Ask 2
  6469.                   EndIf
  6470.                   Display "..."
  6471.  
  6472.  
  6473.  
  6474.  
  6475.  
  6476.  
  6477.  
  6478.                                       - 115 -
  6479.  
  6480.  
  6481.  
  6482.          GETCHOICE <options> <number of variable>
  6483.  
  6484.               eg: GetChoice YN 1
  6485.  
  6486.          Forces the user to give a proper answer, chosen from <options>.
  6487.  
  6488.  
  6489.  
  6490.          OUTPUTANSWER ["<description>"] <number of variable>
  6491.  
  6492.               eg: OutputAnswer "Name: " 1
  6493.  
  6494.          Writes ["<description>"] and the value in <number of variable> to
  6495.          the .ASW-file. <description> is optional.
  6496.  
  6497.  
  6498.  
  6499.          POSTINFO
  6500.  
  6501.          Writes a header to the .ASW-file. The header contains some general
  6502.          information about the user ("Peter Piper answered on ...").
  6503.  
  6504.  
  6505.  
  6506.          QUIT
  6507.  
  6508.          Ends execution of the questionnaire script.
  6509.  
  6510.  
  6511.          SETFLAG <flag> <ON/OFF>
  6512.  
  6513.               eg: SetFlag C ON
  6514.  
  6515.          Sets/clears user flag <flag>. For compatibility with RA, it is
  6516.          also possible to use the QuickBBS/RA flags (A1-D8)
  6517.  
  6518.  
  6519.  
  6520.          SETSECURITY <level>
  6521.  
  6522.               eg: SetSecurity 20
  6523.  
  6524.          Changes the user's security level.
  6525.  
  6526.  
  6527.  
  6528.  
  6529.  
  6530.  
  6531.  
  6532.  
  6533.  
  6534.                                       - 116 -
  6535.  
  6536.  
  6537.  
  6538.          CAPITALISE [On|Off]
  6539.  
  6540.               eg: Capitalise On
  6541.  
  6542.          Changes the way input from the user is displayed. When ON, all
  6543.          characters typed will be converted to uppercase.
  6544.  
  6545.  
  6546.  
  6547.          DISPLAYFILE <filename>
  6548.  
  6549.               eg: DisplayFile TEST
  6550.  
  6551.          Displays <filename>.ANS/ASC. It is identical to menu function 5.
  6552.  
  6553.  
  6554.  
  6555.          EXEC <command>
  6556.  
  6557.               eg: Exec "*ZECHO TEST"
  6558.  
  6559.          Execute a shell. It is identical to function 7. Note that you MUST
  6560.          use quotes (") if the command contains any spaces.
  6561.  
  6562.  
  6563.  
  6564.          LISTANSWER <var-num>
  6565.  
  6566.               eg: ListAnswer 4
  6567.  
  6568.          Displays variable <var-num>, with a CR/LF at the end.
  6569.  
  6570.  
  6571.  
  6572.          MENUCMND <num> [data]
  6573.  
  6574.               eg: MenuCmnd 11 "Yelling SysOp..."
  6575.  
  6576.          Execute any menu command. If the data field contains spaces, you
  6577.          MUST use quotes (").
  6578.  
  6579.  
  6580.  
  6581.          WAITENTER
  6582.  
  6583.               eg: WaitEnter
  6584.  
  6585.          Waits for the <Enter> key.
  6586.  
  6587.  
  6588.  
  6589.  
  6590.                                       - 117 -
  6591.  
  6592.  
  6593.  
  6594.          ┌─────────────────────────────────────────────────────────────────┐
  6595.          │ Function 13: DISPLAY USERLIST                                   │
  6596.          └─────────────────────────────────────────────────────────────────┘
  6597.  
  6598.          DATA: -
  6599.  
  6600.  
  6601.          Prompts the user for a name (or part of a name) and goes looking
  6602.          for it in the name fields of USERS.BBS. If the user doesn't
  6603.          specify a string (if he presses <Enter>), the entire userlist
  6604.          will be displayed.  ProBoard uses a built-in "fuzzy search"
  6605.          algorithm, which will locate specific users even if you misspell
  6606.          their name.
  6607.  
  6608.  
  6609.  
  6610.          ┌─────────────────────────────────────────────────────────────────┐
  6611.          │ Function 14: DISPLAY TIME INFO                                  │
  6612.          └─────────────────────────────────────────────────────────────────┘
  6613.  
  6614.          DATA: -
  6615.  
  6616.  
  6617.          Displays information about the current time, time online,
  6618.          remaining time, etc.
  6619.  
  6620.  
  6621.  
  6622.          ┌─────────────────────────────────────────────────────────────────┐
  6623.          │ Function 15: SHOW ANS/ASC FILE & WAIT                           │
  6624.          └─────────────────────────────────────────────────────────────────┘
  6625.  
  6626.          DATA: <filename>
  6627.  
  6628.  
  6629.          Displays an ANS/ASC-file (like function 5) and waits for the user
  6630.          to press <Enter>.
  6631.  
  6632.  
  6633.  
  6634.          ┌─────────────────────────────────────────────────────────────────┐
  6635.          │ Function 16: CHANGE CITY                                        │
  6636.          └─────────────────────────────────────────────────────────────────┘
  6637.  
  6638.          DATA: -
  6639.  
  6640.  
  6641.          Allows the user to change the city in his user-record.
  6642.  
  6643.  
  6644.  
  6645.  
  6646.                                       - 118 -
  6647.  
  6648.  
  6649.  
  6650.          ┌─────────────────────────────────────────────────────────────────┐
  6651.          │ Function 17: CHANGE PASSWORD                                    │
  6652.          └─────────────────────────────────────────────────────────────────┘
  6653.  
  6654.          DATA: -
  6655.  
  6656.  
  6657.          Allows the user to change his password.
  6658.  
  6659.  
  6660.  
  6661.          ┌─────────────────────────────────────────────────────────────────┐
  6662.          │ Function 18: CHANGE SCREEN LENGTH                               │
  6663.          └─────────────────────────────────────────────────────────────────┘
  6664.  
  6665.          DATA: -
  6666.  
  6667.  
  6668.          Allows the user to change his screen's length (# lines).
  6669.  
  6670.  
  6671.  
  6672.          ┌─────────────────────────────────────────────────────────────────┐
  6673.          │ Function 19: TOGGLE CLEAR SCREEN CODES                          │
  6674.          └─────────────────────────────────────────────────────────────────┘
  6675.  
  6676.          DATA: <blank> or <parameter>
  6677.  
  6678.  
  6679.          Allows the user to decide whether he wants clear screen-codes sent
  6680.          or not.
  6681.  
  6682.          In the data field, you can enter these parameters:
  6683.  
  6684.            Ask       Will ask for new status
  6685.            On        Toggles option on
  6686.            Off       Toggles option off
  6687.            Toggle    Toggles option (reverse of current condition)
  6688.            Save      Save current status for this option
  6689.            Restore   Restore status saved by "Save"
  6690.            /Q        Quiet. Do not display "xxxx is now enabled/disabled"
  6691.  
  6692.          Example: "Ask /Q"
  6693.  
  6694.            This will ask the user if they want to enable or disable screen
  6695.            clearing and ProBoard will not display: "Screen Clearing is now
  6696.            enabled/disabled".
  6697.  
  6698.  
  6699.          "Toggle" parameter.
  6700.  
  6701.  
  6702.                                       - 119 -
  6703.  
  6704.  
  6705.  
  6706.          ┌─────────────────────────────────────────────────────────────────┐
  6707.          │ Function 20: TOGGLE MORE PROMPT                                 │
  6708.          └─────────────────────────────────────────────────────────────────┘
  6709.  
  6710.          DATA: <blank> or <parameter>
  6711.  
  6712.  
  6713.          Allows the user to decide whether scrolling should pause when the
  6714.          screen is full.
  6715.  
  6716.          In the data field, you can enter these parameters:
  6717.  
  6718.            Ask       Will ask for new status
  6719.            On        Toggles option on
  6720.            Off       Toggles option off
  6721.            Toggle    Toggles option (reverse of current condition)
  6722.            Save      Save current status for this option
  6723.            Restore   Restore status saved by "Save"
  6724.            /Q        Quiet. Do not display "xxxx is now enabled/disabled"
  6725.  
  6726.          Example: "Ask /Q"
  6727.  
  6728.            This will ask the user if they want to enable or disable the
  6729.            More? prompt, and ProBoard will not display: "Page Pausing is now
  6730.            enabled/disabled".
  6731.  
  6732.  
  6733.          "Toggle" parameter.
  6734.  
  6735.  
  6736.  
  6737.  
  6738.  
  6739.  
  6740.  
  6741.  
  6742.  
  6743.  
  6744.  
  6745.  
  6746.  
  6747.  
  6748.  
  6749.  
  6750.  
  6751.  
  6752.  
  6753.  
  6754.  
  6755.  
  6756.  
  6757.  
  6758.                                       - 120 -
  6759.  
  6760.  
  6761.  
  6762.          ┌─────────────────────────────────────────────────────────────────┐
  6763.          │ Function 21: TOGGLE ANSI CODES                                  │
  6764.          └─────────────────────────────────────────────────────────────────┘
  6765.  
  6766.          DATA: <blank> or <parameter>
  6767.  
  6768.  
  6769.          Allows the user to choose ANSI graphics/colors or not.
  6770.  
  6771.          In the data field, you can enter these parameters:
  6772.  
  6773.            Ask       Will ask for new status
  6774.            On        Toggles option on
  6775.            Off       Toggles option off
  6776.            Toggle    Toggles option (reverse of current condition)
  6777.            Save      Save current status for this option
  6778.            Restore   Restore status saved by "Save"
  6779.            /Q        Quiet. Do not display "xxxx is now enabled/disabled"
  6780.  
  6781.          Example: "Ask /Q"
  6782.  
  6783.            This will ask the user if they want to enable or disable ANSI,
  6784.            and ProBoard will not display: "ANSI codes enabled/disabled".
  6785.  
  6786.  
  6787.          "Toggle" parameter.
  6788.  
  6789.  
  6790.  
  6791.  
  6792.  
  6793.  
  6794.  
  6795.  
  6796.  
  6797.  
  6798.  
  6799.  
  6800.  
  6801.  
  6802.  
  6803.  
  6804.  
  6805.  
  6806.  
  6807.  
  6808.  
  6809.  
  6810.  
  6811.  
  6812.  
  6813.  
  6814.                                       - 121 -
  6815.  
  6816.  
  6817.  
  6818.          ┌─────────────────────────────────────────────────────────────────┐
  6819.          │ Function 22: CHECK FOR PERSONAL MAIL & FILES                    │
  6820.          └─────────────────────────────────────────────────────────────────┘
  6821.  
  6822.          DATA: <blank> or [/F] or [/M] or both.
  6823.  
  6824.  
  6825.          Searches all the message areas for messages addressed to the user
  6826.          that have not yet been received by him/her.  If ProBoard finds an
  6827.          area with new mail, which the user does not have read access to,
  6828.          it will inform the user, and the SysOp.
  6829.  
  6830.          This function also checks for personal files addressed to the
  6831.          user.
  6832.  
  6833.          Specifying the [/F] option will force ProBoard to check only
  6834.          for new personal files.
  6835.  
  6836.          Specifying the [/M] option will force ProBoard to check only
  6837.          for new personal mail.
  6838.  
  6839.          ProBoard will also find mail addressed to a users alias.
  6840.  
  6841.  
  6842.  
  6843.          ┌─────────────────────────────────────────────────────────────────┐
  6844.          │ Function 23: READ MESSAGES                                      │
  6845.          └─────────────────────────────────────────────────────────────────┘
  6846.  
  6847.          DATA: <area> or <*> or <0>
  6848.  
  6849.  
  6850.          Allows the user to read a message.  If <area> is specified (a
  6851.          number ranging from 1 to 10,00), then only messages from message
  6852.          area <area> can be read.  If <*> is specified, only messages from
  6853.          the active area can be read (refer to the goto/gosub menu
  6854.          functions and to function 49).  If <0> is specified, only messages
  6855.          from areas selected in the combined boards can be read.  When
  6856.          reading messages in combined message areas, messages are read "per
  6857.          area", not in the order of the message number.
  6858.  
  6859.          The user has several options when reading messages:
  6860.  
  6861.             Forward        : First to last.
  6862.  
  6863.             Reverse        : Last to first.
  6864.  
  6865.  
  6866.  
  6867.  
  6868.  
  6869.  
  6870.                                       - 122 -
  6871.  
  6872.  
  6873.  
  6874.             New            : New messages not read by the user.  Messages
  6875.                              are read per area.  If you have new messages
  6876.                              in Area 1 and 5, ProBoard will first show all
  6877.                              new messages in Area 1, then all new messages
  6878.                              in Area 5.
  6879.  
  6880.             Selected       : Messages selected by name or subject.
  6881.  
  6882.             Marked         : Marked messages only.
  6883.  
  6884.  
  6885.          When a message is read, the user has the following options:
  6886.  
  6887.             Next           : Next message.
  6888.  
  6889.             Previous       : Previous Message
  6890.  
  6891.             Again          : Show this message again.
  6892.  
  6893.             Stop           : Stop reading messages.
  6894.  
  6895.             Mark           : Mark this message for later use.
  6896.  
  6897.             Reply          : Reply to this message. The entire message will
  6898.                              be passed to the external fullscreen editor,
  6899.                              thus making it possible to quote text from the
  6900.                              original message in your reply.
  6901.  
  6902.             Unread         : Set this messages status to 'Not received'.
  6903.                              Moves to the next message (if any).
  6904.  
  6905.             Delete         : Delete this message from the message base.
  6906.  
  6907.             Forward        : Copy the message and address it to somebody
  6908.                              else.  This will only work in a LOCAL message
  6909.                              area.
  6910.  
  6911.             Move           : Move this message to another message area.
  6912.  
  6913.             Private        : Toggles the private/public status of the
  6914.                              message.
  6915.  
  6916.             Export         : Export this message to any file.
  6917.  
  6918.             + / -          : Show the next/previous message in the
  6919.                              reply-chain.
  6920.  
  6921.             Original       : Go back to the message where you first used
  6922.                              +/- to follow replies.
  6923.  
  6924.  
  6925.  
  6926.                                       - 123 -
  6927.  
  6928.  
  6929.  
  6930.          ┌─────────────────────────────────────────────────────────────────┐
  6931.          │ Function 24: SCAN MESSAGES                                      │
  6932.          └─────────────────────────────────────────────────────────────────┘
  6933.  
  6934.          DATA: <area> or <*> or <0>
  6935.  
  6936.  
  6937.          Gives an overview of the messages. Only the message-header will
  6938.          be displayed, and the user has the possibility to mark messages
  6939.          for later retrieval. The options follow the same rules as in
  6940.          function 23 (Read messages).
  6941.  
  6942.  
  6943.  
  6944.          ┌─────────────────────────────────────────────────────────────────┐
  6945.          │ Function 25: QUICKSCAN MESSAGES                                 │
  6946.          └─────────────────────────────────────────────────────────────────┘
  6947.  
  6948.          DATA: <area>/<*>/<0>
  6949.  
  6950.  
  6951.          Same as the previous function, but only an overview in short form
  6952.          is displayed. The user does not have the possibility to mark
  6953.          messages. The options follow the same rules as in function 23
  6954.          (Read messages).
  6955.  
  6956.  
  6957.  
  6958.          ┌─────────────────────────────────────────────────────────────────┐
  6959.          │ Function 26: USAGE GRAPH BY DAY (GRAPH)                         │
  6960.          └─────────────────────────────────────────────────────────────────┘
  6961.  
  6962.          DATA: -
  6963.  
  6964.  
  6965.          Displays a graph of your system's use for the last <xx> days.
  6966.          The parameter <xx> is determined by the setting in PROCFG, under
  6967.          Options (F1), System Options, # Usage Graph Days.
  6968.  
  6969.  
  6970.  
  6971.          ┌─────────────────────────────────────────────────────────────────┐
  6972.          │ Function 27: WRITE A MESSAGE                                    │
  6973.          └─────────────────────────────────────────────────────────────────┘
  6974.  
  6975.          DATA: <area> or <*>   [/L]   [/N=Netmail address]   [/T="Name"]
  6976.                [/S="Subject"]
  6977.  
  6978.  
  6979.  
  6980.  
  6981.  
  6982.                                       - 124 -
  6983.  
  6984.  
  6985.  
  6986.  
  6987.  
  6988.          Allows the user to write a message. The area <area> (a number
  6989.          ranging from 1 to 10,000) can be replaced by <*> (refer to
  6990.          function 23).  ProBoard's "fuzzy search" will assist users who
  6991.          enter another users name improperly when they are writing messages
  6992.          in local areas.  ProBoard will search the user file, and give the
  6993.          user a choice of all users whose names are close to what they
  6994.          typed.
  6995.  
  6996.  
  6997.          Optional parameters:
  6998.          ────────────────────
  6999.  
  7000.            /L      The user will be logged off after writing this message.
  7001.  
  7002.            /N      Writes a netmail message to the destination address
  7003.                    specified.  This could also be used to send netmail
  7004.                    to a UUCP gateway.
  7005.  
  7006.            /T      The "To" (the addressee's name) is automatically
  7007.                    specified.  It is not necessary to use quotes (")
  7008.                    when the username does not contain spaces.
  7009.  
  7010.            /S      The subject of the message is automatically specified.
  7011.                    It is not necessary to us quotes (") when the subject
  7012.                    does not contain spaces.
  7013.  
  7014.                    Examples:
  7015.                    ─────────
  7016.  
  7017.                   /N=1:282/30       This would address a netmail message
  7018.                                     to Fidonet node number 1:282/30
  7019.                                     (ProBoard Support USA).
  7020.  
  7021.                   /T=SysOp           Writes a message to the SysOp.
  7022.  
  7023.                   /T="Peter Piper"   Writes a message to Peter Piper.
  7024.  
  7025.                   /S="ProBoard"      Writes a message with the subject line
  7026.                                      already filled in.  The user will not
  7027.                                      be able to change the subject.
  7028.  
  7029.  
  7030.  
  7031.  
  7032.  
  7033.  
  7034.  
  7035.  
  7036.  
  7037.  
  7038.                                       - 125 -
  7039.  
  7040.  
  7041.  
  7042.          ┌─────────────────────────────────────────────────────────────────┐
  7043.          │ Function 28: COMBINED BOARDS SELECT                             │
  7044.          └─────────────────────────────────────────────────────────────────┘
  7045.  
  7046.          DATA: <blank> or [/M]
  7047.  
  7048.  
  7049.          Allows the user to select multiple message areas when using the
  7050.          'combined boards read/scan' function. This is useful when a user
  7051.          is not interested in certain message areas.
  7052.  
  7053.          Also allows users to select which areas ProBoard will check [/M]
  7054.          for new mail. This is very useful for visiting SysOps who don't
  7055.          want to be forced to read echomail they already received on their
  7056.          own system.
  7057.  
  7058.  
  7059.  
  7060.          ┌─────────────────────────────────────────────────────────────────┐
  7061.          │ Function 29: SYSTEM USAGE PER WEEK (GRAPH)                      │
  7062.          └─────────────────────────────────────────────────────────────────┘
  7063.  
  7064.          DATA: -
  7065.  
  7066.  
  7067.          Displays a graph of the system-usage in percent for the last 24
  7068.          weeks.
  7069.  
  7070.  
  7071.  
  7072.          ┌─────────────────────────────────────────────────────────────────┐
  7073.          │ Function 30: SHOW DIRECTORY                                     │
  7074.          └─────────────────────────────────────────────────────────────────┘
  7075.  
  7076.          DATA: [directory name]
  7077.  
  7078.  
  7079.          Shows a list of all the files stored in the specified directory.
  7080.          If no directory is given, the user will be prompted for one.
  7081.  
  7082.  
  7083.  
  7084.  
  7085.  
  7086.  
  7087.  
  7088.  
  7089.  
  7090.  
  7091.  
  7092.  
  7093.  
  7094.                                       - 126 -
  7095.  
  7096.  
  7097.  
  7098.          ┌─────────────────────────────────────────────────────────────────┐
  7099.          │ Function 31: LIST FILES                                         │
  7100.          └─────────────────────────────────────────────────────────────────┘
  7101.  
  7102.          DATA: <area> or <X>
  7103.  
  7104.  
  7105.          Lists the files in the specified file area. If <X> was specified,
  7106.          the files in the active file area will be shown. The list of these
  7107.          files must be stored in a textfile created by the SysOp (refer to
  7108.          file area configuration). This textfile should contain the names
  7109.          and descriptions of the files. The description can be of any form
  7110.          you like.
  7111.  
  7112.          A line in the textfile should look like this:
  7113.  
  7114.          a) <filename> <blanks> <description>
  7115.  
  7116.              Filename + date + size + description will be displayed in the
  7117.              appropriate colors.
  7118.  
  7119.  
  7120.          b) <+> <description>
  7121.  
  7122.              The <+> will cause the description to be placed at the same
  7123.              horizontal cursor position and in the same color as the
  7124.              description from (a). This line will be displayed when
  7125.              searching for files.
  7126.  
  7127.  
  7128.          c) <!> <description>
  7129.  
  7130.              The description will be placed at the left of the screen, in
  7131.              the same color as the descriptions above. This line will be
  7132.              displayed when searching for files.
  7133.  
  7134.  
  7135.          d) <;> <description>
  7136.  
  7137.              Same as in (c), but the color is white.
  7138.  
  7139.  
  7140.          e) <description>
  7141.  
  7142.              Same as in (d), but this line will NOT be displayed when
  7143.              searching for files.
  7144.  
  7145.  
  7146.  
  7147.  
  7148.  
  7149.  
  7150.                                       - 127 -
  7151.  
  7152.  
  7153.  
  7154.          Example:
  7155.  
  7156.          =============================================================
  7157.          PB_215.ZIP ProBoard version 2.15
  7158.          +Best BBS program in the world
  7159.          !Original Belgian Product
  7160.          ;(made possible by Burger King in the USA)
  7161.          =============================================================
  7162.  
  7163.          This will be output as:
  7164.  
  7165.          ============================================================= [c2]
  7166.          PB_215.ZIP   07/08/93 600583    ProBoard version 2.15         [c1]
  7167.                                          Best BBS program in the world [c1]
  7168.          Original Belgian Product                                      [c1]
  7169.          (made possible by Burger King in the USA)                     [c2]
  7170.          ============================================================= [c2]
  7171.  
  7172.          [c1] stands for color 1, [c2] stands for color 2.
  7173.  
  7174.          If a file area is configured as being CD-ROM, the file listing
  7175.          should look slightly different. Option (a) will become:
  7176.  
  7177.          a) <filename><blanks><date><blanks><filesize><blanks><description>
  7178.  
  7179.  
  7180.          There is one more thing you can do to make your file listings more
  7181.          colorful (previously undocumented) : Inserting Ctrl-A to Ctrl-G
  7182.          characters in your file listing will change the color to:
  7183.  
  7184.                 Ctrl-A   Red
  7185.                 Ctrl-B   Green
  7186.                 Ctrl-C   Yellow
  7187.                 Ctrl-D   Magenta
  7188.                 Ctrl-E   Blue
  7189.                 Ctrl-F   Cyan
  7190.                 Ctrl-G   White
  7191.  
  7192.  
  7193.  
  7194.  
  7195.  
  7196.  
  7197.  
  7198.  
  7199.  
  7200.  
  7201.  
  7202.  
  7203.  
  7204.  
  7205.  
  7206.                                       - 128 -
  7207.  
  7208.  
  7209.  
  7210.          ┌─────────────────────────────────────────────────────────────────┐
  7211.          │ Function 32: DOWNLOAD A FILE                                    │
  7212.          └─────────────────────────────────────────────────────────────────┘
  7213.  
  7214.          DATA: <area selection> and/or </parameter>
  7215.  
  7216.  
  7217.          Allows the user to download a file.  The file areas a user can
  7218.          download from are defined by the area selection.  This is a list
  7219.          of area-specifications, separated by blanks. Each specification
  7220.          has the form:
  7221.  
  7222.          [+]<area>
  7223.          <-><area>
  7224.  
  7225.          '+' stands for 'Include this area in the area-list', and is
  7226.              optional.
  7227.          '-' stands for 'Exclude this area from the area-list'.
  7228.  
  7229.          The parameter <area> should be one of the following:
  7230.  
  7231.             *               All areas.
  7232.             C               CD-ROM areas only.
  7233.             X               Currently active area.
  7234.             <n>             Area number <n>.
  7235.             <n1-n2>         Areas <n1> to <n2>.
  7236.  
  7237.          Examples:
  7238.  
  7239.             *               All areas
  7240.             * -C            All non-CD-ROM areas.
  7241.             * -3-9 +5       Areas 1,2,5,10,11,...
  7242.             X +2            Active area + area 2.
  7243.             C -2            All CD-ROM areas, except area 2
  7244.  
  7245.          Of course, a user must have the necessary download security in an
  7246.          area to be allowed to download files from it.
  7247.  
  7248.  
  7249.          You can also specify several other parameters:
  7250.          ──────────────────────────────────────────────
  7251.  
  7252.          /A .......................... Allows the user to download ANY file
  7253.                                        accessible by DOS. When using this
  7254.                                        option, the full path and filename
  7255.                                        must be specified. This option is
  7256.                                        intended for remote SysOps.
  7257.  
  7258.  
  7259.  
  7260.  
  7261.  
  7262.                                       - 129 -
  7263.  
  7264.  
  7265.  
  7266.          /F=<file> ................... The user will not be prompted for a
  7267.                                        file, but the file <file> will
  7268.                                        immediately be sent to the user
  7269.                                        (useful for textfiles describing all
  7270.                                        the files on the BBS).  Parameter
  7271.                                        <file> should contain the full
  7272.                                        path name. (eg. /F=C:\PB\PB.DOC).
  7273.                                        Can also be combined with the </T>
  7274.                                        option (see below).
  7275.  
  7276.          /F=[<area>]<file> ........... Download the <file> from [<area>]
  7277.                                        directly.  The following example
  7278.                                        would download the file PB_215.ZIP
  7279.                                        directly from file area #13.
  7280.                                        e.g. /F=[13]PB_215.ZIP
  7281.  
  7282.          /F=@<filelist> .............. Download the files listed in the
  7283.                                        textfile <filelist>.
  7284.                                        e.g.  /F=@C:\PB\ALLFILES.RSP
  7285.  
  7286.          /I .......................... Ignore DL kbytes.
  7287.  
  7288.          /K=<key> .................... Use the protocol key <key>.
  7289.  
  7290.          /L=<log> .................... Write to an additional log file
  7291.                                        <log>.  The format for each line is:
  7292.                                        <D/U> <area> <file> <size>
  7293.                                        <free YES/NO>.
  7294.  
  7295.          /N .......................... No log.  Don't log anything.
  7296.  
  7297.  
  7298.          /P .......................... Download all personal files for the
  7299.                                        user.
  7300.  
  7301.          /Q .......................... Start download right away without
  7302.                                        prompting the user.  You must use the
  7303.                                        /F= and the /K= parameters so
  7304.                                        ProBoard knows what file to send,
  7305.                                        using what protocol when using this
  7306.                                        option.
  7307.  
  7308.  
  7309.  
  7310.  
  7311.  
  7312.  
  7313.  
  7314.  
  7315.  
  7316.  
  7317.  
  7318.                                       - 130 -
  7319.  
  7320.  
  7321.  
  7322.          /T .......................... Allow the user to download the
  7323.                                        specified file without checking
  7324.                                        the users remaining time left.
  7325.                                        Refer to "Free Files" for more
  7326.                                        details.  Let's say you want to
  7327.                                        let users download the latest
  7328.                                        version of ProBoard and you don't
  7329.                                        care about the time it takes or how
  7330.                                        much time they have left.  In the
  7331.                                        data line put the path and file name
  7332.                                        followed by the </T> parameter.
  7333.                                        An example of doing this is as
  7334.                                        follows:
  7335.  
  7336.                                        C:\FREEFILE\PB_215.ZIP /T
  7337.  
  7338.          A Small hint regarding free files: if you want one particular area
  7339.          to be completely free (time and Kb), you can make a menu choice
  7340.          like this:
  7341.  
  7342.            Function: 32
  7343.            Data    : 41 /T
  7344.  
  7345.          This will allow the user to download anything from area 41, regardless
  7346.          of their time remaining.
  7347.  
  7348.          ProBoard will now also copy files from CD-ROM to a local drive when
  7349.          the "Copy Local" flag is set to "Yes".  It will copy files to a
  7350.          directory called CD_TEMP, created in the directory where ProBoard
  7351.          was started from.  You can specify your own directory by creating
  7352.          an environment variable called CDTEMP containing the name of the
  7353.          directory (+drive!!)  If ProBoard can not find the directory as
  7354.          specified it will attempt to create it.  Refer to the chapter
  7355.          "CONFIGURATION" under File Areas, for more information on the
  7356.          "Copy Local" and CDTEMP environment variable options in ProBoard.
  7357.  
  7358.  
  7359.          ** Important **
  7360.          ───────────────
  7361.          ProBoard uses a highly optimized index to find your files when
  7362.          users want to download them.  Be sure to run PBUTIL FI (File
  7363.          Index) at least once a day to create the index, or ProBoard will
  7364.          not be able to find the files.  You may want to run it more often
  7365.          than once a day if you add new files to your system.
  7366.  
  7367.  
  7368.  
  7369.  
  7370.  
  7371.  
  7372.  
  7373.  
  7374.                                       - 131 -
  7375.  
  7376.  
  7377.  
  7378.          ┌─────────────────────────────────────────────────────────────────┐
  7379.          │ Function 33: UPLOAD A FILE                                      │
  7380.          └─────────────────────────────────────────────────────────────────┘
  7381.  
  7382.          DATA: <uploadpath> or </parameter>
  7383.  
  7384.  
  7385.          Allows the user to upload a file to the BBS. If <uploadpath> is
  7386.          specified, the upload will be placed in that directory. If not,
  7387.          it will be placed in the default upload-directory specified in
  7388.          PROCFG. (Unregistered versions of ProBoard will always use the
  7389.          default upload directory).
  7390.  
  7391.          Upon successful reception of the file, the user will be prompted
  7392.          for a description of that file. The description can be several
  7393.          lines. If it begins with a '/', this description will be written
  7394.          to the file FILES.PVT in the upload-directory, else it will be
  7395.          written to the file FILES.BBS.
  7396.  
  7397.          All uploads are now logged to a file in the ProBoard System
  7398.          Directory called UPLOAD.LOG.  The log file is in the following
  7399.          format:
  7400.  
  7401.             01-Feb-94 14:52:38 Upload of PB_215.ZIP  by Jim Biggs
  7402.             01-Feb-94 14:56:01 Upload of PROCFG.EXE  by Philippe Leybaert
  7403.  
  7404.  
  7405.          The parameters you can specify are:
  7406.          ───────────────────────────────────
  7407.  
  7408.          /D .......................... Do not ask user for upload
  7409.                                        descriptions.
  7410.  
  7411.          /F=<file> ................... Upload <file> (for non-batch
  7412.                                        protocols).
  7413.  
  7414.          /K=<key> .................... Use protocol key <key>.
  7415.  
  7416.          /L=<log> .................... Write to an additional log file
  7417.                                        <log>.  The format for each line is:
  7418.                                        U O <file> <size> NO.
  7419.  
  7420.          /N .......................... No log.  Do not log anything.
  7421.  
  7422.          /P .......................... Upload private files.  If the data
  7423.                                        field contains "/P", the user can
  7424.                                        upload a personal file to another
  7425.                                        user.  In this case the upload will
  7426.                                        be placed in the private upload
  7427.                                        directory (specified in ProCFG).
  7428.  
  7429.  
  7430.                                       - 132 -
  7431.  
  7432.  
  7433.  
  7434.          /Q .......................... Start upload right away, without
  7435.                                        prompting the user.  You must specify
  7436.                                        a /K=<key> for this to work.
  7437.  
  7438.  
  7439.  
  7440.          ┌─────────────────────────────────────────────────────────────────┐
  7441.          │ Function 34: VIEW ARCHIVE                                       │
  7442.          └─────────────────────────────────────────────────────────────────┘
  7443.  
  7444.          DATA: <area selection>
  7445.  
  7446.  
  7447.          View the contents of a ZIP/LZH/ZOO/ARC/ARJ/RAR-file. The file
  7448.          specification input by the user will be looked for in the areas
  7449.          specified in <area selection>. ProBoard's Archive Viewer looks
  7450.          at the contents or "header" of the file the user selects to view
  7451.          to determine it's archive type rather than the file's extension
  7452.          (.ZIP/.ARJ etc...)  This function now uses the file index to locate
  7453.          the archive to view so it is much faster than in previous releases
  7454.          of ProBoard.  Please refer to Menu Function 32 (Download) for more
  7455.          information.
  7456.  
  7457.  
  7458.  
  7459.          ┌─────────────────────────────────────────────────────────────────┐
  7460.          │ Function 35: KEYWORD SEARCH                                     │
  7461.          └─────────────────────────────────────────────────────────────────┘
  7462.  
  7463.          DATA: <area selection> [/FG] [/FG=group]
  7464.  
  7465.  
  7466.          Looks for a character string in the file descriptions. If the
  7467.          string is found, the related file and its description will be
  7468.          displayed. The character string will be looked for in the areas
  7469.          specified in <area selection>.  ProBoard now supports keyword
  7470.          searches in lines starting with | (PCBoard CD-ROM lists) such as
  7471.          the popular Night Owl CD-ROM's.  This means a keyword will be
  7472.          found in these extended descriptions as well.  Please refer to
  7473.          Menu Function 32 (Download) for more information.
  7474.  
  7475.          Option /FG will search only in the areas in the currently selected
  7476.          file group.  You can define a file group to search in by
  7477.          specifiying a group number in /FG=<group number>.
  7478.  
  7479.  
  7480.  
  7481.  
  7482.  
  7483.  
  7484.  
  7485.  
  7486.                                       - 133 -
  7487.  
  7488.  
  7489.  
  7490.          ┌─────────────────────────────────────────────────────────────────┐
  7491.          │ Function 36: FILENAME SEARCH                                    │
  7492.          └─────────────────────────────────────────────────────────────────┘
  7493.  
  7494.          DATA: <area selection> [/FG] [/FG=group]
  7495.  
  7496.  
  7497.          Looks for a filename in the file listings (wildcards allowed).
  7498.          The filename will be looked for in the areas specified in
  7499.          <area selection>. Refer to function 32 (Download) for more
  7500.          information.
  7501.  
  7502.          Option /FG will search only in the areas in the currently selected
  7503.          file group.  You can define a file group to search in by
  7504.          specifiying a group number in /FG=<group number>.
  7505.  
  7506.  
  7507.  
  7508.          ┌─────────────────────────────────────────────────────────────────┐
  7509.          │ Function 37: SHOW NEW FILES                                     │
  7510.          └─────────────────────────────────────────────────────────────────┘
  7511.  
  7512.          DATA: <area selection> [/FG] [/FG=group]
  7513.  
  7514.  
  7515.          Shows a list of files more recent than a date specified by the
  7516.          user. If the user does not specify a date, then that date will be
  7517.          the last time this user logged in. The files will be looked for
  7518.          in the areas specified in <area selection>. Please refer to
  7519.          function 32 (Download) for more information.
  7520.  
  7521.          Option /FG will search only in the areas in the currently selected
  7522.          file group.  You can define a file group to search in by
  7523.          specifiying a group number in /FG=<group number>.
  7524.  
  7525.  
  7526.  
  7527.          ┌─────────────────────────────────────────────────────────────────┐
  7528.          │ Function 38: VIEW A FILE                                        │
  7529.          └─────────────────────────────────────────────────────────────────┘
  7530.  
  7531.          DATA: <directory>
  7532.  
  7533.  
  7534.          This functions asks for a filename, and then looks for (and shows)
  7535.          the file stored in <directory>.
  7536.  
  7537.  
  7538.  
  7539.  
  7540.  
  7541.  
  7542.                                       - 134 -
  7543.  
  7544.  
  7545.  
  7546.          ┌─────────────────────────────────────────────────────────────────┐
  7547.          │ Function 39: DISPLAY NAMED FILE                                 │
  7548.          └─────────────────────────────────────────────────────────────────┘
  7549.  
  7550.          DATA: <full filename>
  7551.  
  7552.  
  7553.          Displays a file to the user. The data field <full filename> must
  7554.          contain path, name and extension.
  7555.  
  7556.  
  7557.  
  7558.          ┌─────────────────────────────────────────────────────────────────┐
  7559.          │ Function 40: DISPLAY ANS/ASC FILE WITH MENU HOTKEYS             │
  7560.          └─────────────────────────────────────────────────────────────────┘
  7561.  
  7562.          DATA: <filename without extension>
  7563.  
  7564.  
  7565.          This function is the same as function 5, but can only be used in
  7566.          'autoexec-menus', because it shows an ANS/ASC-file AND checks for
  7567.          menu hotkeys at the same time. Please refer to the section about
  7568.          menus for more information about the autoexec-concept.
  7569.  
  7570.  
  7571.  
  7572.  
  7573.  
  7574.  
  7575.  
  7576.  
  7577.  
  7578.  
  7579.  
  7580.  
  7581.  
  7582.  
  7583.  
  7584.  
  7585.  
  7586.  
  7587.  
  7588.  
  7589.  
  7590.  
  7591.  
  7592.  
  7593.  
  7594.  
  7595.  
  7596.  
  7597.  
  7598.                                       - 135 -
  7599.  
  7600.  
  7601.  
  7602.          ┌─────────────────────────────────────────────────────────────────┐
  7603.          │ Function 41: TOGGLE FULLSCREEN EDITOR                           │
  7604.          └─────────────────────────────────────────────────────────────────┘
  7605.  
  7606.          DATA: <blank> or <parameter>
  7607.  
  7608.  
  7609.          Lets the user decide whether they want to use ProBoard's line
  7610.          editor or an (external) fullscreen editor.
  7611.  
  7612.          In the data field, you can enter these parameters:
  7613.  
  7614.            Ask       Will ask for new status
  7615.            On        Toggles option on
  7616.            Off       Toggles option off
  7617.            Toggle    Toggles option (reverse of current condition)
  7618.            Save      Save current status for this option
  7619.            Restore   Restore status saved by "Save"
  7620.            /Q        Quiet. Do not display "xxxx is now enabled/disabled"
  7621.  
  7622.          Example: "Ask /Q"
  7623.  
  7624.            This will ask the user if they want to enable or disable the
  7625.            full screen (external) editor, and ProBoard will not display:
  7626.            "Full Screen editor is now enabled/disabled".
  7627.  
  7628.  
  7629.          "Toggle" parameter.
  7630.  
  7631.  
  7632.  
  7633.          ┌─────────────────────────────────────────────────────────────────┐
  7634.          │ Function 42: TOGGLE COMMAND STACKING                            │
  7635.          └─────────────────────────────────────────────────────────────────┘
  7636.  
  7637.          DATA: -
  7638.  
  7639.  
  7640.          Lets the user decide whether he will work with hotkeys or with
  7641.          combinations of hotkeys and command stacking (à la Opus). The
  7642.          command stack execution is initiated by pressing <Enter>.
  7643.          A ';' in the command stack will be replaced by <Enter>.
  7644.  
  7645.          Eg.  M1WSysOp;Subject;Y
  7646.  
  7647.          This would write a private message in message area 1 to the SysOp,
  7648.          with subject "Subject".
  7649.  
  7650.  
  7651.  
  7652.  
  7653.  
  7654.                                       - 136 -
  7655.  
  7656.  
  7657.  
  7658.          ┌─────────────────────────────────────────────────────────────────┐
  7659.          │ Function 43: CLEAR MARKED MESSAGES                              │
  7660.          └─────────────────────────────────────────────────────────────────┘
  7661.  
  7662.          DATA: -
  7663.  
  7664.  
  7665.          Clears all marked messages.
  7666.  
  7667.  
  7668.  
  7669.          ┌─────────────────────────────────────────────────────────────────┐
  7670.          │ Function 44: GLOBAL COMBINED BOARDS SELECTION                   │
  7671.          └─────────────────────────────────────────────────────────────────┘
  7672.  
  7673.          DATA: -
  7674.  
  7675.  
  7676.          Allows the user to select or deselect all areas in his combined
  7677.          boards selection.
  7678.  
  7679.  
  7680.  
  7681.          ┌─────────────────────────────────────────────────────────────────┐
  7682.          │ Function 45: DISPLAY TEXTFILE & WAIT                            │
  7683.          └─────────────────────────────────────────────────────────────────┘
  7684.  
  7685.          DATA: <full filename>
  7686.  
  7687.  
  7688.          Displays a textfile to the user, then waits for the user to press
  7689.          <Enter>. The filename requires full path, name and extension.
  7690.  
  7691.  
  7692.  
  7693.          ┌─────────────────────────────────────────────────────────────────┐
  7694.          │ Function 46: CHANGE USER LEVEL AND/OR FLAGS                     │
  7695.          └─────────────────────────────────────────────────────────────────┘
  7696.  
  7697.          DATA: [level] [flag +/-] [flag +/-] ...
  7698.  
  7699.  
  7700.          Changes a user's level and/or flags. [level] can occur only once
  7701.          in the parameter array, flags can be toggled on/off by specifying
  7702.          the flag, followed by +/-.
  7703.  
  7704.          Data example:   10 A+ 3-
  7705.  
  7706.          This would set the user's level to 10, set flag A and clear flag 3.
  7707.  
  7708.  
  7709.  
  7710.                                       - 137 -
  7711.  
  7712.  
  7713.  
  7714.          ┌─────────────────────────────────────────────────────────────────┐
  7715.          │ Function 47: MAKE A LOG ENTRY                                   │
  7716.          └─────────────────────────────────────────────────────────────────┘
  7717.  
  7718.          DATA: <log entry>
  7719.  
  7720.  
  7721.          Writes <log entry> to PROBOARD.LOG, thus allowing the SysOp to
  7722.          customize his log.
  7723.  
  7724.  
  7725.  
  7726.          ┌─────────────────────────────────────────────────────────────────┐
  7727.          │ Function 48: SHOW HITPARADE                                     │
  7728.          └─────────────────────────────────────────────────────────────────┘
  7729.  
  7730.          DATA: <Mn>/<Kn>/<Tn>/<Un>/<Fn>/<Cn>/<On>
  7731.  
  7732.  
  7733.          This functions returns an overview of the most active users in
  7734.          several fields.
  7735.  
  7736.          The 'n' with the parameters stands for the number of users to be
  7737.          displayed in the hitparade. (unregistered versions default to 5)
  7738.  
  7739.             M   Best message-writers
  7740.             K   Best downloaders (Kb)
  7741.             T   Best downloaders (# downloads)
  7742.             U   Best uploaders (Kb)
  7743.             F   Best uploaders (# uploads)
  7744.             C   Best callers (# times called)
  7745.             O   Total time online
  7746.  
  7747.          Data example:   U15
  7748.  
  7749.  
  7750.  
  7751.  
  7752.  
  7753.  
  7754.  
  7755.  
  7756.  
  7757.  
  7758.  
  7759.  
  7760.  
  7761.  
  7762.  
  7763.  
  7764.  
  7765.  
  7766.                                       - 138 -
  7767.  
  7768.  
  7769.  
  7770.          ┌─────────────────────────────────────────────────────────────────┐
  7771.          │ Function 49: SELECT MESSAGE AREA                                │
  7772.          └─────────────────────────────────────────────────────────────────┘
  7773.  
  7774.          DATA: <area selection> or </parameter>
  7775.  
  7776.          Lets the user select a new message area.  This function is to be
  7777.          used in cooperation with other message-related functions.
  7778.  
  7779.          Valid area selection parameters are:
  7780.          ────────────────────────────────────
  7781.  
  7782.            X          Current Area
  7783.            E          All Echo Areas
  7784.            N          All NetMail Areas
  7785.            L          All Local Areas
  7786.            *          All Areas
  7787.            <n>        Area #<n>
  7788.            <n1>-<n2>  Areas #<n1> to #<n2>
  7789.  
  7790.          Other valid parameters are:
  7791.          ───────────────────────────
  7792.  
  7793.          /MG ......................... Makes the user select a message group
  7794.                                        if they haven't done so already.
  7795.  
  7796.          /MG=<num> ................... Only allows user to select from
  7797.                                        message areas belonging to message
  7798.                                        group <num>.
  7799.  
  7800.          /N .......................... ProBoard will run even faster since
  7801.                                        it will not check for waiting mail
  7802.                                        (no "*" will be displayed indicating
  7803.                                        new mail) if you specify this
  7804.                                        parameter.  This can be useful if
  7805.                                        your BBS has many large message
  7806.                                        areas, in particular, Squish or JAM.
  7807.                                        Remember, ProBoard can be configured
  7808.                                        for 10,000 message areas so a full
  7809.                                        "new" mail check in each area can
  7810.                                        be time consuming.
  7811.  
  7812.          Examples:
  7813.          ─────────
  7814.            * -E          All non-echomail areas
  7815.            1-20 50-60    Areas 1..20 and 50..60
  7816.            N 10-20 -15   All netmail areas, plus areas 10..20, except
  7817.                          area #15
  7818.            /N            Do not have ProBoard perform the new mail check
  7819.                          in each message area.  Great for Squish and JAM.
  7820.  
  7821.  
  7822.                                       - 139 -
  7823.  
  7824.  
  7825.  
  7826.          Note:
  7827.          ─────
  7828.          Since ProBoard parses only the first letter of an alpha area
  7829.          selection, the keywords from prior versions, [Local / Net / Echo]
  7830.          can still be used and will still work.  It is recommended however,
  7831.          that you change to the new parameter(s) since the keywords
  7832.          [Local / Net / Echo] may not be supported in upcoming versions.
  7833.  
  7834.  
  7835.  
  7836.          ┌─────────────────────────────────────────────────────────────────┐
  7837.          │ Function 50: SHOW USERS ONLINE                                  │
  7838.          └─────────────────────────────────────────────────────────────────┘
  7839.  
  7840.          DATA: <blank> or /H
  7841.  
  7842.  
  7843.          Displays users who are logged in on other nodes. Of course, this
  7844.          function is only useful on multi-user systems.  To protect  the
  7845.          SysOp's health, it is possible not to display the SysOp's
  7846.          name here (Refer to the ProCFG section).
  7847.  
  7848.          Valid parameters are:
  7849.          ─────────────────────
  7850.          /H .......................... Show the user's handle (alias)
  7851.                                        instead of their real name.
  7852.  
  7853.          <blank> ..................... Will display the user's real name.
  7854.  
  7855.  
  7856.  
  7857.          ┌─────────────────────────────────────────────────────────────────┐
  7858.          │ Function 51: LIST LAST CALLERS                                  │
  7859.          └─────────────────────────────────────────────────────────────────┘
  7860.  
  7861.          DATA: <number of users to be displayed> [/H]
  7862.  
  7863.  
  7864.          Gives an overview of the users that have most recently logged in
  7865.          (for ALL the nodes). In the non-registered version, the number
  7866.          of users shown is forced to 5.  Specifying the parameter /H will
  7867.          show the user's aliases instead of their real names.
  7868.  
  7869.  
  7870.  
  7871.  
  7872.  
  7873.  
  7874.  
  7875.  
  7876.  
  7877.  
  7878.                                       - 140 -
  7879.  
  7880.  
  7881.  
  7882.          ┌─────────────────────────────────────────────────────────────────┐
  7883.          │ Function 52: REMOTE USER EDITOR                                 │
  7884.          └─────────────────────────────────────────────────────────────────┘
  7885.  
  7886.          DATA: -
  7887.  
  7888.  
  7889.          Allows you to adjust a user's level (or even delete him), without
  7890.          you having to be at the computer (VERY handy for co-SysOps!).
  7891.  
  7892.  
  7893.  
  7894.          ┌─────────────────────────────────────────────────────────────────┐
  7895.          │ Function 53: MULTILINE CHAT (INTERNODE CHAT)                    │
  7896.          └─────────────────────────────────────────────────────────────────┘
  7897.  
  7898.          DATA: - <blank> or /H
  7899.  
  7900.  
  7901.          This is certainly one of the nicest Menu Functions in ProBoard!
  7902.          This function allows two users on different nodes to chat with
  7903.          each other IN REAL TIME!!! You will actually see the other user
  7904.          type (mistakes?), as if you were in chat-mode with the SysOp. This
  7905.          is UNlike other systems, where entire LINES are sent to the other
  7906.          node.
  7907.  
  7908.          User A on node X will have to specify the node he wants to chat
  7909.          with, then user B on node Y will be prompted if he wants
  7910.          to chat.
  7911.  
  7912.          It is VERY (!VERY!) important that your system supports full file
  7913.          & record locking to use this option. When you are not running a
  7914.          LAN, you MUST install SHARE.EXE! ProBoard will definitely lock up
  7915.          when SHARE.EXE is not installed on a stand-alone system.
  7916.  
  7917.          Valid parameters are:
  7918.          ─────────────────────
  7919.          /H .......................... Will show the users handle (alias)
  7920.                                        instead of their real name to
  7921.                                        the users on other nodes, when
  7922.                                        prompting them to engage in a chat.
  7923.  
  7924.          <blank> ..................... Will display the users real name
  7925.                                        instead of their alias when
  7926.                                        prompting users on other nodes to
  7927.                                        engage in a chat.
  7928.  
  7929.  
  7930.  
  7931.  
  7932.  
  7933.  
  7934.                                       - 141 -
  7935.  
  7936.  
  7937.  
  7938.          ┌─────────────────────────────────────────────────────────────────┐
  7939.          │ Function 54: SELECT FILE AREA                                   │
  7940.          └─────────────────────────────────────────────────────────────────┘
  7941.  
  7942.          DATA: <area selection> or </parameter>
  7943.  
  7944.  
  7945.          Lets the user select a new file area. This function is to be used
  7946.          in cooperation with other file-related functions. Refer to
  7947.          functions 1 and 32 for more information.
  7948.  
  7949.          Valid parameters are:
  7950.          ─────────────────────
  7951.  
  7952.          /FG ......................... Makes a user select a file group if
  7953.                                        they haven't done so already.
  7954.  
  7955.          /FG=0 ....................... Makes the user always have to select
  7956.                                        a file group.
  7957.  
  7958.          /FG=<num> ................... Only display file areas belonging to
  7959.                                        file group number <num>.
  7960.  
  7961.  
  7962.  
  7963.          ┌─────────────────────────────────────────────────────────────────┐
  7964.          │ Function 55: SHOW .GIF FILE INFO                                │
  7965.          └─────────────────────────────────────────────────────────────────┘
  7966.  
  7967.          DATA: <area selection>
  7968.  
  7969.  
  7970.          Prompts the user for a .GIF-filename (wildcards allowed) and
  7971.          displays resolution and number of colors for the file(s). The
  7972.          files will be looked for in <area selection>. Refer to function 32
  7973.          (Download) for more information.
  7974.  
  7975.  
  7976.  
  7977.          ┌─────────────────────────────────────────────────────────────────┐
  7978.          │ Function 56: TOGGLE IBM CHARACTERS                              │
  7979.          └─────────────────────────────────────────────────────────────────┘
  7980.  
  7981.          DATA: -
  7982.  
  7983.  
  7984.          Allows the user to disable/enable extended IBM characters. When
  7985.          disabled, all IBM-specific characters are converted to standard
  7986.          ASCII characters ("+-|")
  7987.  
  7988.  
  7989.  
  7990.                                       - 142 -
  7991.  
  7992.  
  7993.  
  7994.          ┌─────────────────────────────────────────────────────────────────┐
  7995.          │ Function 57: CHANGE PHONE NUMBER                                │
  7996.          └─────────────────────────────────────────────────────────────────┘
  7997.  
  7998.          DATA: -
  7999.  
  8000.  
  8001.          Allows the user to change his phone number stored in his user
  8002.          record.
  8003.  
  8004.  
  8005.  
  8006.          ┌─────────────────────────────────────────────────────────────────┐
  8007.          │ Function 58: CHANGE DATA/FAX PHONE NUMBER                       │
  8008.          └─────────────────────────────────────────────────────────────────┘
  8009.  
  8010.          DATA: -
  8011.  
  8012.  
  8013.          Allows the user to change his data/fax phone number stored in his
  8014.          user record.
  8015.  
  8016.  
  8017.  
  8018.          ┌─────────────────────────────────────────────────────────────────┐
  8019.          │ Function 59: CHANGE USER ALIAS                                  │
  8020.          └─────────────────────────────────────────────────────────────────┘
  8021.  
  8022.          DATA: -
  8023.  
  8024.  
  8025.          Allows the user to change his alias. It is not allowed to use an
  8026.          alias that is being used by another user.
  8027.  
  8028.  
  8029.  
  8030.  
  8031.  
  8032.  
  8033.  
  8034.  
  8035.  
  8036.  
  8037.  
  8038.  
  8039.  
  8040.  
  8041.  
  8042.  
  8043.  
  8044.  
  8045.  
  8046.                                       - 143 -
  8047.  
  8048.  
  8049.  
  8050.          ┌─────────────────────────────────────────────────────────────────┐
  8051.          │ Function 60: RUN PROBOARD SDK FILE                              │
  8052.          └─────────────────────────────────────────────────────────────────┘
  8053.  
  8054.          DATA: <program> [data]
  8055.  
  8056.  
  8057.          Loads & executes a ProBoard Executable (PEX file) created using
  8058.          the ProBoard Software Development Kit (SDK).  The PEX file can be
  8059.          run from any directory.  It is the responsibility of the PEX
  8060.          programmer to search for the appropriate data files when their
  8061.          PEX is run.  If you are not sure if the PEX you are running does
  8062.          this then it's a good idea to place the PEX file directory
  8063.          (Specified in PROCFG, F1-Options, Paths, PEX Files).
  8064.  
  8065.          Important
  8066.          ─────────
  8067.          Any PEX files that were written for versions of ProBoard prior to
  8068.          2.00 will have to be recompiled with the new 2.1x SDK before they
  8069.          can run under ProBoard 2.15
  8070.  
  8071.  
  8072.  
  8073.          ┌─────────────────────────────────────────────────────────────────┐
  8074.          │ Function 61: BULLETIN MENU                                      │
  8075.          └─────────────────────────────────────────────────────────────────┘
  8076.  
  8077.          DATA: <filename> [prompt]
  8078.  
  8079.  
  8080.          Displays <filename>.ANS/ASC (like function 5), and prompts the
  8081.          user for a file suffix. This suffix is appended to <filename>, and
  8082.          the file with the resulting filename is displayed. Obviously,
  8083.          <filename> should not be longer than 7 characters.
  8084.          The optional [prompt] parameters defines a prompt to be shown to
  8085.          the user. For example: Enter a bulletin.
  8086.  
  8087.          Data example: BULLET Enter a bulletin:
  8088.  
  8089.  
  8090.  
  8091.  
  8092.  
  8093.  
  8094.  
  8095.  
  8096.  
  8097.  
  8098.  
  8099.  
  8100.  
  8101.  
  8102.                                       - 144 -
  8103.  
  8104.  
  8105.  
  8106.          ┌─────────────────────────────────────────────────────────────────┐
  8107.          │ Function 62: TOGGLE AVATAR/0                                    │
  8108.          └─────────────────────────────────────────────────────────────────┘
  8109.  
  8110.          DATA: <blank> or <parameter>
  8111.  
  8112.  
  8113.          Allows the user to toggle AVATAR/0 on/off in their user record.
  8114.  
  8115.          In the data field, you can enter these parameters:
  8116.  
  8117.            Ask       Will ask for new status
  8118.            On        Toggles option on
  8119.            Off       Toggles option off
  8120.            Toggle    Toggles option (reverse of current condition)
  8121.            Save      Save current status for this option
  8122.            Restore   Restore status saved by "Save"
  8123.            /Q        Quiet. Do not display "xxxx is now enabled/disabled"
  8124.  
  8125.          Example: "Ask /Q"
  8126.  
  8127.            This will ask the user if they want to enable or disable AVATAR/0
  8128.            screen display codes, and ProBoard will not display: "Avatar
  8129.            codes are now enabled/disabled".
  8130.  
  8131.  
  8132.          "Toggle" parameter.
  8133.  
  8134.  
  8135.  
  8136.  
  8137.  
  8138.  
  8139.  
  8140.  
  8141.  
  8142.  
  8143.  
  8144.  
  8145.  
  8146.  
  8147.  
  8148.  
  8149.  
  8150.  
  8151.  
  8152.  
  8153.  
  8154.  
  8155.  
  8156.  
  8157.  
  8158.                                       - 145 -
  8159.  
  8160.  
  8161.  
  8162.          ┌─────────────────────────────────────────────────────────────────┐
  8163.          │ Function 63: TOGGLE AVATAR/0+                                   │
  8164.          └─────────────────────────────────────────────────────────────────┘
  8165.  
  8166.          DATA: <blank> or <parameter>
  8167.  
  8168.  
  8169.          Allows the user to toggle AVATAR/0+ on/off in their user record.
  8170.  
  8171.          In the data field, you can enter these parameters:
  8172.  
  8173.            Ask       Will ask for new status
  8174.            On        Toggles option on
  8175.            Off       Toggles option off
  8176.            Toggle    Toggles option (reverse of current condition)
  8177.            Save      Save current status for this option
  8178.            Restore   Restore status saved by "Save"
  8179.            /Q        Quiet. Do not display "xxxx is now enabled/disabled"
  8180.  
  8181.          Example: "Ask /Q"
  8182.  
  8183.            This will ask the user if they want to enable or disable
  8184.            AVATAR/0+ screen display codes, and ProBoard will not
  8185.            display: "AVT/0+ codes are now enabled/disabled".
  8186.  
  8187.  
  8188.          "Toggle" parameter.
  8189.  
  8190.  
  8191.  
  8192.          ┌─────────────────────────────────────────────────────────────────┐
  8193.          │ Function 64: Show Graph (General)                               │
  8194.          └─────────────────────────────────────────────────────────────────┘
  8195.  
  8196.          DATA: <graph type> [/N=<days>] [/T="text"]
  8197.  
  8198.  
  8199.          This menu function is a direct system hook to the _GRAPH.PEX file
  8200.          supplied in PB_215.ZIP
  8201.  
  8202.            <graph type>  "Hourly", "Weekly", "LastDays" or "Speed".
  8203.  
  8204.            /N=<days>     Number of days to read from BINLOG.PB (Optional)
  8205.  
  8206.            /T="text"     Text to display on the top bar of your graph.
  8207.                          A "%d" (no quotes) is replaced by the number of
  8208.                          days/weeks
  8209.  
  8210.  
  8211.  
  8212.  
  8213.  
  8214.                                       - 146 -
  8215.  
  8216.  
  8217.  
  8218.          Example:
  8219.          ────────
  8220.            Hourly /N=14 /T="Usage graph for the last 2 weeks"
  8221.            Speed  /N=60 /T="Cool baud rate statistics for the last %d days"
  8222.  
  8223.  
  8224.          The C++ source code for _GRAPH.PEX is included with ProBoard.
  8225.  
  8226.          You can add your own <graph type> by editing and compiling the
  8227.          _GRAPH.CPP file.
  8228.  
  8229.  
  8230.  
  8231.          ┌─────────────────────────────────────────────────────────────────┐
  8232.          │ Function 65: Display A??/RIP File with Hotkeys                  │
  8233.          └─────────────────────────────────────────────────────────────────┘
  8234.  
  8235.          DATA: -
  8236.  
  8237.  
  8238.          Allows you to display an A??/RIP file to users.  Very similar to
  8239.          Menu Function 40 except that RIP files are supported.
  8240.  
  8241.  
  8242.  
  8243.          ┌─────────────────────────────────────────────────────────────────┐
  8244.          │ Function 66: Change RIPscrip Font                               │
  8245.          └─────────────────────────────────────────────────────────────────┘
  8246.  
  8247.          DATA: -
  8248.  
  8249.  
  8250.          Allows the user to select either the large RIP font (80x24) or
  8251.          the small RIP font (80x43) for displaying system prompts etc.
  8252.  
  8253.  
  8254.  
  8255.  
  8256.  
  8257.  
  8258.  
  8259.  
  8260.  
  8261.  
  8262.  
  8263.  
  8264.  
  8265.  
  8266.  
  8267.  
  8268.  
  8269.  
  8270.                                       - 147 -
  8271.  
  8272.  
  8273.  
  8274.          ┌─────────────────────────────────────────────────────────────────┐
  8275.          │ Function 67: Toggle RIPscrip Graphics                           │
  8276.          └─────────────────────────────────────────────────────────────────┘
  8277.  
  8278.          DATA: - <blank> or <parameter>
  8279.  
  8280.  
  8281.          Allows the user to toggle RIP graphics on/off.
  8282.  
  8283.          In the data field, you can enter these parameters:
  8284.  
  8285.            Ask       Will ask for new status
  8286.            On        Toggles option on
  8287.            Off       Toggles option off
  8288.            Toggle    Toggles option (reverse of current condition)
  8289.            Save      Save current status for this option
  8290.            Restore   Restore status saved by "Save"
  8291.            /Q        Quiet. Do not display "xxxx is now enabled/disabled"
  8292.  
  8293.          Example: "Ask /Q"
  8294.  
  8295.            This will ask the user if they want to enable or disable
  8296.            RIP graphics, and ProBoard will not display: "RIPscrip graphics
  8297.            are now enabled/disabled".
  8298.  
  8299.  
  8300.          "Toggle" parameter.
  8301.  
  8302.  
  8303.  
  8304.          ┌─────────────────────────────────────────────────────────────────┐
  8305.          │ Function 68: Edit Tagged Files                                  │
  8306.          └─────────────────────────────────────────────────────────────────┘
  8307.  
  8308.          DATA: -
  8309.  
  8310.  
  8311.          Allows users to edit the list of tagged files.
  8312.  
  8313.  
  8314.  
  8315.          ┌─────────────────────────────────────────────────────────────────┐
  8316.          │ Function 69: Select a New Language                              │
  8317.          └─────────────────────────────────────────────────────────────────┘
  8318.  
  8319.          DATA: -
  8320.  
  8321.  
  8322.          Allows users to select a new language file for the system prompts.
  8323.  
  8324.  
  8325.  
  8326.                                       - 148 -
  8327.  
  8328.  
  8329.  
  8330.          ┌─────────────────────────────────────────────────────────────────┐
  8331.          │ Function 70: Change Date Format                                 │
  8332.          └─────────────────────────────────────────────────────────────────┘
  8333.  
  8334.          DATA: -
  8335.  
  8336.  
  8337.          Allows the user to select a new date format for system date
  8338.          displays.  Valid choices are: MM/DD/YY, YY/MM/DD, and DD/MM/YY.
  8339.  
  8340.  
  8341.  
  8342.          ┌─────────────────────────────────────────────────────────────────┐
  8343.          │ Function 71: Change Mailing Address                             │
  8344.          └─────────────────────────────────────────────────────────────────┘
  8345.  
  8346.          DATA: -
  8347.  
  8348.  
  8349.          Allows the user to change their mailing address.  Displays users
  8350.          current mailing address (if any) and presents a new line for them
  8351.          to begin typing.  If nothing is typed on this first line by the
  8352.          user, the change mailing address function is terminated.
  8353.  
  8354.  
  8355.  
  8356.          ┌─────────────────────────────────────────────────────────────────┐
  8357.          │ Function 72: Change FAX Number                                  │
  8358.          └─────────────────────────────────────────────────────────────────┘
  8359.  
  8360.          DATA: -
  8361.  
  8362.  
  8363.          Allows the user to change the FAX Number in their user record.
  8364.  
  8365.  
  8366.  
  8367.          ┌─────────────────────────────────────────────────────────────────┐
  8368.          │ Function 73: Change Country                                     │
  8369.          └─────────────────────────────────────────────────────────────────┘
  8370.  
  8371.          DATA: -
  8372.  
  8373.  
  8374.          Allows the user to change the country in their user record.
  8375.  
  8376.  
  8377.  
  8378.  
  8379.  
  8380.  
  8381.  
  8382.                                       - 149 -
  8383.  
  8384.  
  8385.  
  8386.          ┌─────────────────────────────────────────────────────────────────┐
  8387.          │ Function 74: Change Default Protocol                            │
  8388.          └─────────────────────────────────────────────────────────────────┘
  8389.  
  8390.          DATA: -
  8391.  
  8392.  
  8393.          Allows the user to change the default protocol for downloads and
  8394.          uploads.  ProBoard will no longer ask for a protocol when a
  8395.          download or upload session is started.
  8396.  
  8397.  
  8398.  
  8399.          ┌─────────────────────────────────────────────────────────────────┐
  8400.          │ Function 75: Select Message Area Group                          │
  8401.          └─────────────────────────────────────────────────────────────────┘
  8402.  
  8403.          DATA: -
  8404.  
  8405.  
  8406.          Selects a new message area group.  See function 49 for more
  8407.          information.
  8408.  
  8409.  
  8410.  
  8411.          ┌─────────────────────────────────────────────────────────────────┐
  8412.          │ Function 76: Select File Area Group                             │
  8413.          └─────────────────────────────────────────────────────────────────┘
  8414.  
  8415.          DATA: -
  8416.  
  8417.  
  8418.          Selects a new file area group.  See function 54 for more
  8419.          information.
  8420.  
  8421.  
  8422.  
  8423.  
  8424.  
  8425.  
  8426.  
  8427.  
  8428.  
  8429.  
  8430.  
  8431.  
  8432.  
  8433.  
  8434.  
  8435.  
  8436.  
  8437.  
  8438.                                       - 150 -
  8439.  
  8440.  
  8441.  
  8442.          ╔═════════════════════════════════════════════════════════════════╗
  8443.          ╟─── RIPscrip GRAPHICS (RIP) ─────────────────────────────────────╢
  8444.          ╚═════════════════════════════════════════════════════════════════╝
  8445.  
  8446.  
  8447.          ProBoard auto-detects and supports RIPscrip (referred to as RIP)
  8448.          Graphics.
  8449.  
  8450.          A flashing "R" on the right side of the status bar indicates the
  8451.          RIP was detected.  ProBoard will display the file INTRO?.RIP
  8452.          (if it exists) instead of INTRO?.ANS/ASC (only if RIP is detected).
  8453.  
  8454.          Missing Icons are automatically sent to the caller.  You must have
  8455.          a Zmodem protocol installed with a hotkey of "Z" for this to work.
  8456.  
  8457.          ProBoard's built in message reader is fully RIP capable as are the
  8458.          "More" prompt, the "Enter" prompt and several other internal
  8459.          ProBoard functions.  Almost all of the internal ANS/ASC/AVT files
  8460.          can be replaced with RIP files.  You need only create a RIP file
  8461.          with the proper name and copy it into your RIP directory.
  8462.  
  8463.          To add your own RIP menus to ProBoard, do the following:
  8464.  
  8465.          Once you have designed a RIP screen for your menu, you can add it
  8466.          to a menu by pressing Alt-P (Prompt) in the menu editor.  You will
  8467.          be able to set "RIP menu" to "Yes", and enter a file name for a RIP
  8468.          screen.  Enter the name of your RIP screen here.  That's all there
  8469.          is to it!
  8470.  
  8471.          There are some additional settings you can change for each menu
  8472.          item, which makes the RIP support in ProBoard extremely flexible:
  8473.  
  8474.          - Show remote
  8475.                * Send menu-line/ANSI-file to remote when RIP enabled
  8476.                (Default No).
  8477.  
  8478.          - Show local
  8479.                * Send menu-line/ANSI-file to local screen when RIP
  8480.                enabled (Default Yes).
  8481.  
  8482.          - Reset screen
  8483.                * Reset RIP windows before executing this function.
  8484.                (Default Yes).
  8485.  
  8486.  
  8487.  
  8488.  
  8489.  
  8490.  
  8491.  
  8492.  
  8493.  
  8494.                                       - 151 -
  8495.  
  8496.  
  8497.  
  8498.          These options are very powerful.  When the user has RIP enabled,
  8499.          the SysOp will still see the "normal" ANSI screens.  Don't touch
  8500.          the defaults if you want it like that.  You will see that the RIP
  8501.          support in ProBoard is a lot friendlier towards to SysOp than in
  8502.          other BBS software.  On the local end, the SysOp will see
  8503.          everything as if the user had no RIP enabled.  This allows the
  8504.          SysOp to follow what the user is doing.  (Other software like RA
  8505.          and Wildcat show the RIP "bang" commands, which are totally
  8506.          unreadable for the SysOp).
  8507.  
  8508.  
  8509.          Two new menu functions have also been added to support RIP.
  8510.          ───────────────────────────────────────────────────────────
  8511.  
  8512.          Function 66:  Change RIP text font (large or small) for non-RIP
  8513.                        screens.
  8514.  
  8515.          Function 67:  Enable/Disable RIP.  Allows the user to disable RIP
  8516.                        even it was detected.
  8517.  
  8518.  
  8519.  
  8520.  
  8521.  
  8522.  
  8523.  
  8524.  
  8525.  
  8526.  
  8527.  
  8528.  
  8529.  
  8530.  
  8531.  
  8532.  
  8533.  
  8534.  
  8535.  
  8536.  
  8537.  
  8538.  
  8539.  
  8540.  
  8541.  
  8542.  
  8543.  
  8544.  
  8545.  
  8546.  
  8547.  
  8548.  
  8549.  
  8550.                                       - 152 -
  8551.  
  8552.  
  8553.  
  8554.          ╔═════════════════════════════════════════════════════════════════╗
  8555.          ╟─── FILE TAGGING ────────────────────────────────────────────────╢
  8556.          ╚═════════════════════════════════════════════════════════════════╝
  8557.  
  8558.  
  8559.          ProBoard supports file tagging when users are browsing the file
  8560.          list, performing a keyword or file search, or performing a new
  8561.          file search.  File tagging allows your users to easily select
  8562.          files they want to download as they browse your available files.
  8563.  
  8564.  
  8565.  
  8566.  
  8567.  
  8568.  
  8569.  
  8570.  
  8571.  
  8572.  
  8573.  
  8574.  
  8575.  
  8576.  
  8577.  
  8578.  
  8579.  
  8580.  
  8581.  
  8582.  
  8583.  
  8584.  
  8585.  
  8586.  
  8587.  
  8588.  
  8589.  
  8590.  
  8591.  
  8592.  
  8593.  
  8594.  
  8595.  
  8596.  
  8597.  
  8598.  
  8599.  
  8600.  
  8601.  
  8602.  
  8603.  
  8604.  
  8605.  
  8606.                                       - 153 -
  8607.  
  8608.  
  8609.  
  8610.          ╔═════════════════════════════════════════════════════════════════╗
  8611.          ╟─── QWK ─────────────────────────────────────────────────────────╢
  8612.          ╚═════════════════════════════════════════════════════════════════╝
  8613.  
  8614.  
  8615.          Internal ProBoard QWK support has been added!  It is provided
  8616.          as a PEX file called QWK.PEX.  The only things necessary to
  8617.          configure are the following:
  8618.  
  8619.          - The packet file name your BBS will create (ProCFG/Options/QWK).
  8620.  
  8621.          - The QWK area name in each message area configuration.
  8622.  
  8623.          Call the QWK PEX as any you would any other PEX file.  No
  8624.          configuration files are necessary.  One parameter can be given:
  8625.          "D" (ie "QWK D").  This will pack all mail and start the download
  8626.          right away.
  8627.  
  8628.  
  8629.  
  8630.  
  8631.  
  8632.  
  8633.  
  8634.  
  8635.  
  8636.  
  8637.  
  8638.  
  8639.  
  8640.  
  8641.  
  8642.  
  8643.  
  8644.  
  8645.  
  8646.  
  8647.  
  8648.  
  8649.  
  8650.  
  8651.  
  8652.  
  8653.  
  8654.  
  8655.  
  8656.  
  8657.  
  8658.  
  8659.  
  8660.  
  8661.  
  8662.                                       - 154 -
  8663.  
  8664.  
  8665.  
  8666.          ╔═════════════════════════════════════════════════════════════════╗
  8667.          ╟─── USERS ───────────────────────────────────────────────────────╢
  8668.          ╚═════════════════════════════════════════════════════════════════╝
  8669.  
  8670.  
  8671.          The file USERS.BBS contains all the data about the users, such as
  8672.          level, number of times called, combined boards access, messages
  8673.          last read, etc. Use ProBoard's User Editor to add/edit/delete
  8674.          users in the USERS.BBS file.  If you delete users you must
  8675.          run PBUTIL [UK].  More info on this in the section on PBUTIL.
  8676.  
  8677.  
  8678.  
  8679.          ┌─────────────────────────────────────────────────────────────────┐
  8680.          │ Log Levels                                                      │
  8681.          └─────────────────────────────────────────────────────────────────┘
  8682.  
  8683.          Each user has a certain loglevel, to determine how information
  8684.          about that user will be written to ProBoard's log (PROBOARD.LOG).
  8685.  
  8686.          This can be useful if you suspect a user of logging in using 2
  8687.          different names. If you give those users a higher log level, you
  8688.          can track their behavior.
  8689.  
  8690.          The following levels are possible:
  8691.          ──────────────────────────────────
  8692.  
  8693.              Friend          * NOTHING BUT login, logoff and errors
  8694.                                will be logged.
  8695.  
  8696.              Normal          * Login
  8697.                              * Logoff
  8698.                              * Errors
  8699.                              * Writing SysOp messages
  8700.                              * SysOp paging
  8701.                              * Downloads
  8702.                              * Uploads
  8703.                              * Questionnaires
  8704.  
  8705.              Suspicious      * Everything from 'Normal'
  8706.                              * Reading messages
  8707.                              * Hitparades
  8708.                              * Last callers
  8709.                              * Graphics
  8710.  
  8711.              Extensive       * Everything from 'Suspicious'
  8712.                              * ALL the movements between menus (this can
  8713.                                make the logfile HUGE)
  8714.  
  8715.  
  8716.  
  8717.  
  8718.                                       - 155 -
  8719.  
  8720.  
  8721.  
  8722.          ╔═════════════════════════════════════════════════════════════════╗
  8723.          ╟─── ECHOMAIL AND NETMAIL ────────────────────────────────────────╢
  8724.          ╚═════════════════════════════════════════════════════════════════╝
  8725.  
  8726.  
  8727.          ProBoard fully supports Echomail and Netmail, according to the
  8728.          FTSC (FidoNet Technical Standards Committee) specifications.
  8729.  
  8730.  
  8731.  
  8732.          ┌─────────────────────────────────────────────────────────────────┐
  8733.          │ Echomail                                                        │
  8734.          └─────────────────────────────────────────────────────────────────┘
  8735.  
  8736.          When a user enters a message in a message area configured as an
  8737.          Echomail area, an origin line will be added to that message. This
  8738.          origin line is obtained from the message area's configuration. If
  8739.          there is no origin line specified for this message area, the
  8740.          default origin line will be used.  The default origin line is
  8741.          specified in PROCFG under Options (F1) - Site Info, in the field
  8742.          "Default Origin Line".
  8743.  
  8744.          To import/export Echomail, you need an Echomail processor. No
  8745.          such program is included, but since ProBoard uses the .MSG
  8746.          (Fido), Squish, or Hudson message-base structures, a large number
  8747.          of Echomail processors are available that will work with ProBoard.
  8748.  
  8749.          Some of the echomail-processors compatible with ProBoard are:
  8750.  
  8751.             - Squish            - FastEcho          - IMail
  8752.             - GEcho             - FMail             - FreeMail
  8753.  
  8754.  
  8755.  
  8756.          ┌─────────────────────────────────────────────────────────────────┐
  8757.          │ Netmail                                                         │
  8758.          └─────────────────────────────────────────────────────────────────┘
  8759.  
  8760.          A Netmail message (in short: Netmail) is a message that has a
  8761.          fixed destination within the network. This destination is
  8762.          defined by a node-number of the form "Zone:Net/Node.Point".
  8763.          ProBoard will first find out whether this address exists, and
  8764.          will then (if it exists) tell you the name of the node where
  8765.          the Netmail is to be sent to.
  8766.  
  8767.  
  8768.  
  8769.  
  8770.  
  8771.  
  8772.  
  8773.  
  8774.                                       - 156 -
  8775.  
  8776.  
  8777.  
  8778.          When entering a node number in ProBoard, it is possible to look
  8779.          up the nodes you want by entering a '?'.
  8780.  
  8781.          eg:   ?        Shows a list of all zones.
  8782.                2:?      Shows a list of all nets and regions in zone 2.
  8783.                2:292/?  Shows a list of all nodes in net 2:292/
  8784.  
  8785.          ProBoard needs a nodelist to use Netmail. This nodelist is
  8786.          usually available on every node in the network. ProBoard
  8787.          generates an index file for its own use (NODE_IDX.PRO) by running
  8788.          PBUTIL NC.
  8789.  
  8790.          For more information about PBUTIL's NC-option, please refer to the
  8791.          section on PBUTIL.
  8792.  
  8793.          To import and export Netmail, you need an external utility like
  8794.          MAILSCAN ,MBUTIL or ZmailH.
  8795.  
  8796.  
  8797.  
  8798.  
  8799.  
  8800.  
  8801.  
  8802.  
  8803.  
  8804.  
  8805.  
  8806.  
  8807.  
  8808.  
  8809.  
  8810.  
  8811.  
  8812.  
  8813.  
  8814.  
  8815.  
  8816.  
  8817.  
  8818.  
  8819.  
  8820.  
  8821.  
  8822.  
  8823.  
  8824.  
  8825.  
  8826.  
  8827.  
  8828.  
  8829.  
  8830.                                       - 157 -
  8831.  
  8832.  
  8833.  
  8834.          ╔═════════════════════════════════════════════════════════════════╗
  8835.          ╟─── PBUTIL (The ProBoard Utility Program) ───────────────────────╢
  8836.          ╚═════════════════════════════════════════════════════════════════╝
  8837.  
  8838.  
  8839.          PBUTIL is an extra utility provided with the ProBoard package.
  8840.          It performs all of the maintenance your ProBoard BBS system needs.
  8841.  
  8842.          Some PBUTIL Operations have Options and/or Parameters that can be
  8843.          specified on the command line when running them.  Operations
  8844.          which have command line Options and/or Parameters are identified
  8845.          in the list below with a "(+)" after their "Operation Identifier",
  8846.          (the two letters necessary to begin each PBUTIL operation).
  8847.  
  8848.          PBUTIL is called along with an "Operation Identifier" (a two
  8849.          letter sequence specifying the operation to be executed (along
  8850.          with any options):
  8851.  
  8852.           PBUTIL <operation> [option]
  8853.  
  8854.          PBUTIL Operation  Description              Options/Parameters
  8855.          ────────────────  ───────────────────────  ────────────────────────
  8856.          DM (+) .........  Daily Maintenance        -H
  8857.          FB .............  Fix BINLOG.PB
  8858.          FC (+) .........  File Counters            -N<x> -F -R
  8859.          FI .............  FILES.BBS (re)-Indexer
  8860.          HF (+) .........  Hatch Personal File      <files> -T= -F= -D -C
  8861.          MI .............  Message (re)-Indexer
  8862.          ML .............  Message Linker
  8863.          MP (+) .........  Message Packer           -R -D -F -K -H -J
  8864.          MU .............  Music Player
  8865.          NC .............  Nodelist Compiler
  8866.          UF .............  Userfile Fixer
  8867.          UI .............  Userfile (re)-Indexer
  8868.          UK (+) .........  Userfile Killer          -C<n> -D<n> -L<evel>
  8869.          UP (+) .........  Userfile Packer          -R -K
  8870.          US .............  Userfile Sorter
  8871.  
  8872.          PBUTIL can be run from any directory provided that it (PBUTIL.EXE)
  8873.          is found in your DOS path.  Refer to your DOS manual for more
  8874.          information on the PATH statement.
  8875.  
  8876.  
  8877.  
  8878.  
  8879.  
  8880.  
  8881.  
  8882.  
  8883.  
  8884.  
  8885.  
  8886.                                       - 158 -
  8887.  
  8888.  
  8889.  
  8890.          ┌─────────────────────────────────────────────────────────────────┐
  8891.          │ [DM] Daily Maintenance                                          │
  8892.          └─────────────────────────────────────────────────────────────────┘
  8893.  
  8894.          At this time, the DM function of PBUTIL has only one function: it
  8895.          (re)creates TOPS.PRO.  You should run it as part of your daily
  8896.          maintenace.  If you specify the -H option, the file TOPS.PRO will
  8897.          be created using the user's aliases instead of their real names.
  8898.  
  8899.  
  8900.  
  8901.          ┌─────────────────────────────────────────────────────────────────┐
  8902.          │ [FB] Fix BINLOG.PB                                              │
  8903.          └─────────────────────────────────────────────────────────────────┘
  8904.  
  8905.          You should run PBUTIL FB if you ever receive the message that your
  8906.          BINLOG.PB file is corrupt.  This "fix" routine will remove any and
  8907.          all unreadable data from the BINLOG.PB file.  For more information
  8908.          on BINLOG.PB, refer to Menu Functions 10, 26, 29 and 64.
  8909.  
  8910.  
  8911.  
  8912.          ┌─────────────────────────────────────────────────────────────────┐
  8913.          │ [FC] File Counters                                              │
  8914.          └─────────────────────────────────────────────────────────────────┘
  8915.  
  8916.          After each download, ProBoard adds a line to the file DOWNLOAD.LOG.
  8917.          This file's only purpose is to be used by the FC module of PBUtil.
  8918.          FC reads the file DOWNLOAD.LOG and updates file counters in every
  8919.          file listing, to keep up with the number of times every file
  8920.          has been downloaded.
  8921.  
  8922.          Specifying option -N<xx> instructs PBUtil to create a list of the
  8923.          top-xx downloaded files. This list is named TOPFILES.A?? and
  8924.          is stored in the textfiles-subdirectory. The number of files to be
  8925.          written in this list is <xx>, (eg. -N15).
  8926.  
  8927.          Specifying option -F instructs PBUtil to ALWAYS create
  8928.          TOPFILES.ASC/ANS/AVT/AVP, even if DOWNLOAD.LOG is empty or
  8929.          doesn't exist.
  8930.  
  8931.          Option -R rewrites all file listings with the appropriate file
  8932.          count added to each file. This is useful when you have added some
  8933.          new files.
  8934.  
  8935.  
  8936.  
  8937.  
  8938.  
  8939.  
  8940.  
  8941.  
  8942.                                       - 159 -
  8943.  
  8944.  
  8945.  
  8946.          The file counters will be placed before the description of the
  8947.          files.
  8948.  
  8949.          Eg. PB_215.ZIP  [809]  Superb BBS program from Belgium !!!!
  8950.                          ^^^^^
  8951.                      File Counter - shows how many times file has been
  8952.                                     downloaded.
  8953.  
  8954.  
  8955.          You can create a file called NOTOPS.CTL to exclude files from being
  8956.          included when the TOPFILES.A?? is created.  The format of this file
  8957.          is just <filename>.<extension>  Example as follows:
  8958.  
  8959.          BLACK.ZIP
  8960.          NOWAY.EXE
  8961.          RA_111.ARJ
  8962.  
  8963.  
  8964.  
  8965.          ┌─────────────────────────────────────────────────────────────────┐
  8966.          │ [FI] File Indexer                                               │
  8967.          └─────────────────────────────────────────────────────────────────┘
  8968.  
  8969.          When you run PBUTIL FI, ProBoard reads each of your file listings
  8970.          defined in your file areas and creates an index (FILESIDX.PB).
  8971.          ProBoard now only supports indexed FILES.BBS.  ProBoard will use
  8972.          the index to find files users specify they want to download.
  8973.          This dramatically speeds up locating files on systems with many
  8974.          different file areas, especially those on CD-ROM drives.  Since
  8975.          files that are not in your file index will not be found for users
  8976.          to download, be sure to run PBUTIL FI at lease once each day.
  8977.  
  8978.  
  8979.  
  8980.          ┌─────────────────────────────────────────────────────────────────┐
  8981.          │ [HF] Hatch Personal File                                        │
  8982.          └─────────────────────────────────────────────────────────────────┘
  8983.  
  8984.          Personal files can be setup to be sent to users (hatched) from the
  8985.          command line (instead of using the PROCFG/Personal Files menu
  8986.          interface) using PBUTIL's "Hatch File" (HF) function.
  8987.  
  8988.          Any personal files you setup (hatch) using the PBUTIL HF method
  8989.          will appear in the PROCFG/Personal File menu interface for later
  8990.          review and administration.
  8991.  
  8992.          The syntax for PBUTIL HF is:
  8993.          ────────────────────────────
  8994.  
  8995.          PBUTIL HF files [files...] /T=ToName /F=FromName /D /C
  8996.  
  8997.  
  8998.                                       - 160 -
  8999.  
  9000.  
  9001.  
  9002.          The following are valid options for PBUTIL HF:
  9003.          ──────────────────────────────────────────────
  9004.  
  9005.          <files>      A list of the file(s) to be sent as personal file(s).
  9006.                       Wildcards and paths are allowed.  If the /C option is
  9007.                       not used, the files will NOT be copied to the
  9008.                       personal files directory specified in PROCFG
  9009.                       Options/Paths.  If no path is given, PBUTIL will
  9010.                       search in the current directory first.  If no files
  9011.                       could be found in the current directory, the personal
  9012.                       files directory will be searched.
  9013.  
  9014.          /T=ToName    The name of the user to send the files to.
  9015.                       Underscores must be used for spaces in names.
  9016.                       ProBoard does not check the user file for valid
  9017.                       user names to be entered here so be careful when
  9018.                       typing user names that you spell them correctly.
  9019.  
  9020.          /F=FromName  The name of the sender of the files.  If not
  9021.                       specified, the name of the SysOp is used.  Again,
  9022.                       underscores must be used for spaces.  ProBoard does
  9023.                       not check the user file for valid user names to be
  9024.                       entered here so be careful when typing user names
  9025.                       that you spell them correctly.
  9026.  
  9027.          /D           Sets the "KILL" (delete) flag for the hatched
  9028.                       file(s).  This means that the files will be deleted
  9029.                       after they have been downloaded by the user if this
  9030.                       is specified on the command line.
  9031.  
  9032.          /C           Copy the specified file(s) to the Personal Files
  9033.                       Directory (specified in PROCFG/Options/Paths).  Make
  9034.                       sure if you use this option, that you also use the /D
  9035.                       option in addition, otherwise the files won't be
  9036.                       deleted after download from your Personal Files
  9037.                       Directory.
  9038.  
  9039.          Examples:
  9040.          ─────────
  9041.  
  9042.          PBUTIL HF C:\PB\PB_215.ZIP /T=Philippe_Leybaert /C /D
  9043.          PBUTIL HF *.TXT /T=John_Doe /F=Joe_Sysop
  9044.  
  9045.  
  9046.  
  9047.  
  9048.  
  9049.  
  9050.  
  9051.  
  9052.  
  9053.  
  9054.                                       - 161 -
  9055.  
  9056.  
  9057.  
  9058.          ┌─────────────────────────────────────────────────────────────────┐
  9059.          │ [MI] Message Indexer  (Hudson and JAM Only)                     │
  9060.          └─────────────────────────────────────────────────────────────────┘
  9061.  
  9062.          Recreates the message base index files (MSGIDX.BBS,MSGTOIDX.BBS
  9063.          and MSGINFO.BBS) for Hudson and (*.JDX) files for JAM areas.
  9064.  
  9065.  
  9066.  
  9067.          ┌─────────────────────────────────────────────────────────────────┐
  9068.          │ [ML] Message Linker  (Hudson Only)                              │
  9069.          └─────────────────────────────────────────────────────────────────┘
  9070.  
  9071.          Completely rebuilds reply chains in all areas. This operation has
  9072.          to be performed when echomail is imported into the message base
  9073.          and after using the message packer with the -D parameter.
  9074.  
  9075.  
  9076.  
  9077.          ┌─────────────────────────────────────────────────────────────────┐
  9078.          │ [MP] Message Packer  (Hudson and JAM Only)                      │
  9079.          └─────────────────────────────────────────────────────────────────┘
  9080.  
  9081.          Packs the message base.  This means that the deleted messages are
  9082.          effectively removed from the message base.
  9083.  
  9084.  
  9085.  
  9086.  
  9087.  
  9088.  
  9089.  
  9090.  
  9091.  
  9092.  
  9093.  
  9094.  
  9095.  
  9096.  
  9097.  
  9098.  
  9099.  
  9100.  
  9101.  
  9102.  
  9103.  
  9104.  
  9105.  
  9106.  
  9107.  
  9108.  
  9109.  
  9110.                                       - 162 -
  9111.  
  9112.  
  9113.  
  9114.          The following are valid options for PBUTIL MP:
  9115.          ──────────────────────────────────────────────
  9116.  
  9117.          -D .......................... Removes old messages. Check the
  9118.                                        section of the manual about the
  9119.                                        message areas for more information.
  9120.  
  9121.          -F .......................... Forces the pack to be executed, even
  9122.                                        if there are no deleted messages
  9123.                                        (Hudson Only!)
  9124.  
  9125.          -H .......................... Instructs the message packer to pack
  9126.                                        the Hudson areas only.
  9127.  
  9128.          -J .......................... Instructs the message packer to pack
  9129.                                        the JAM areas only.
  9130.  
  9131.          -K .......................... Deletes the .BAK files created when
  9132.                                        packing the message base. (Hudson
  9133.                                        Only!)
  9134.  
  9135.          -R .......................... Instructs the message packer to
  9136.                                        renumber the message base.
  9137.                                        Renumbering the message base is
  9138.                                        done automatically when the highest
  9139.                                        message number exceeds 25000.
  9140.                                        Lastread-pointers in the userfile
  9141.                                        will be adjusted when renumbering.
  9142.  
  9143.          Do NOT pack the message base when a user is online!!
  9144.          ───────────────────────────────────────────────────
  9145.  
  9146.  
  9147.  
  9148.          ┌─────────────────────────────────────────────────────────────────┐
  9149.          │ [MU] Music Player                                               │
  9150.          └─────────────────────────────────────────────────────────────────┘
  9151.  
  9152.          Use this to play/test any music files you create for ProBoard.
  9153.  
  9154.          Music files MUST have .MUS as the file extension.  The file played
  9155.          when a user "Yells" for the SysOp (paging) is called PAGE.MUS and
  9156.          the "Attention" music file is called ATTEN.MUS
  9157.  
  9158.              Examples:  PBUTIL MU PAGE  (plays the paging music file)
  9159.                         PBUTIL MU ATTEN (plays the attention music file)
  9160.  
  9161.              Note: It is not necessary to include the file extension when
  9162.                    using PBUTIL MU to play a music file.
  9163.  
  9164.  
  9165.  
  9166.                                       - 163 -
  9167.  
  9168.  
  9169.  
  9170.          ┌─────────────────────────────────────────────────────────────────┐
  9171.          │ [NC] Nodelist Compiler                                          │
  9172.          └─────────────────────────────────────────────────────────────────┘
  9173.  
  9174.          Reads a FidoNet-compatible nodelist and creates a ProBoard index-
  9175.          file (NODE_IDX.PRO) in the system directory. This file will be
  9176.          less than 10K in size, but your original nodelist has to stay in
  9177.          the nodelist directory.
  9178.  
  9179.          The compiler will look for the latest standard nodelist
  9180.          (NODELIST.xxx) in your nodelist directory.
  9181.  
  9182.          Specifying extra files as parameters instructs the nodelist
  9183.          compiler to compile extra nodelists. Several extra nodelists can
  9184.          be given as parameters. If you don't specify an extension, ProBoard
  9185.          will look for the latest file with extension .nnn (nnn=day number).
  9186.          If you want to compile a file without an extension, use <FILE>.
  9187.  
  9188.            Eg. PBUTIL NC MYNL MYLIST. FDNET.PVT
  9189.  
  9190.          This would compile the latest NODELIST.nnn, the latest MYNL.nnn,
  9191.          MYLIST and FDNET.PVT in the standard nodelist directory.
  9192.  
  9193.          To determine the costs of sending Netmail, a textfile will be read
  9194.          that you will have to create. This textfile is called COST.PRO and
  9195.          should be in ProBoard's system directory. The lines in this file
  9196.          have the following format:
  9197.  
  9198.              <Command> <Param1> [Param2]
  9199.  
  9200.  
  9201.          Commands:
  9202.  
  9203.          MYZONE <zone>                 All commands after this command act
  9204.                                        on zone <zone>. You need at least
  9205.                                        1 MYZONE command. If not, ProBoard
  9206.                                        will assume you are in zone 2. This
  9207.                                        is used to specify your own zone.
  9208.  
  9209.          DEFAULT <cost>                Defines the default Netmail cost.
  9210.  
  9211.          ZONE <zone> <cost>            Defines the Netmail cost for zone
  9212.                                        <zone>.
  9213.  
  9214.          REGION <region> <cost>        Defines the Netmail cost for region
  9215.                                        <region> within your own zone.
  9216.  
  9217.          NET <net> <cost>              Defines the Netmail cost for net
  9218.                                        <net> within your own zone.
  9219.  
  9220.  
  9221.  
  9222.                                       - 164 -
  9223.  
  9224.  
  9225.  
  9226.          A simple example for a node in Belgium, where the BBS is part
  9227.          of only ONE network.
  9228.  
  9229.            MYZONE   2         I'm in zone 2
  9230.            DEFAULT   100      Default = 100 credits
  9231.            ZONE     3 50      Zone 3 = 50 credits (Australia)
  9232.            ZONE     1 40      Zone 1 = 40 credits (North-America)
  9233.            REGION  28 10      Region 28 = 10 credits (Netherlands)
  9234.            REGION  29  0      Region 29 = FREE (Belgium)
  9235.            NET    512  5      Net 512 = 5 (HCC Netherlands)
  9236.  
  9237.  
  9238.          We give another example for a node which is part of 2 networks,
  9239.          so this node has nodenumbers 2:292/1900 and 89:120/40
  9240.  
  9241.            DEFAULT    100     Default = 100 credits
  9242.            ZONE     1  50     Zone 1  =  50 credits
  9243.            ZONE     2  20     Zone 2  =  20 credits
  9244.            ZONE     3  70     Zone 4  =  70 credits
  9245.            ZONE    89  10     My private network = 10 credits
  9246.  
  9247.            MYZONE   2         Following definitions are for zone 2
  9248.            REGION  29   1     Region 29 in zone 2  = 1 credit
  9249.            NET    292   0     Net 292   in zone 2  = 0 credits
  9250.            NET    512   5     Net 512   in zone 2  = 5 credits
  9251.  
  9252.            MYZONE  89         Following definitions are for zone 89
  9253.            REGION  12  2      Region 12 in zone 89 = 2 credits
  9254.            NET    120  0      Net 120   in zone 89 = 0 credits
  9255.  
  9256.  
  9257.  
  9258.          ┌─────────────────────────────────────────────────────────────────┐
  9259.          │ [UF] UserFile Fixer                                             │
  9260.          └─────────────────────────────────────────────────────────────────┘
  9261.  
  9262.          Run this after you use a user file packer/sorter from another
  9263.          source (like RAUSER or RACE).  It assures that the extensions in
  9264.          ProBoard's user file are updated properly.
  9265.  
  9266.  
  9267.  
  9268.          ┌─────────────────────────────────────────────────────────────────┐
  9269.          │ [UI] UserFile Indexer                                           │
  9270.          └─────────────────────────────────────────────────────────────────┘
  9271.  
  9272.          Creates an index for the user file.  ProBoard uses this index
  9273.          file to search in the user file.  This greatly reduces the time
  9274.          needed to locate a user at login.
  9275.  
  9276.  
  9277.  
  9278.                                       - 165 -
  9279.  
  9280.  
  9281.  
  9282.          ┌─────────────────────────────────────────────────────────────────┐
  9283.          │ [UK] UserFile Killer                                            │
  9284.          └─────────────────────────────────────────────────────────────────┘
  9285.  
  9286.          Deletes (kills) certain users from your user file.  The criteria
  9287.          are:  not having called for a certain number of days, less than a
  9288.          certain number of times called, a certain security level or a
  9289.          combination of these three.
  9290.  
  9291.          Parameters to use:
  9292.          ──────────────────
  9293.  
  9294.              -D<# of days>   Removes all users that haven't called for
  9295.                              <# of days>.
  9296.  
  9297.              -C<calls>       Removes all users that have called
  9298.                              less than <calls> times.
  9299.  
  9300.              -L<evel>        Specifies a specific security level for
  9301.                              the User Killer to work on.
  9302.  
  9303.          Combining these three parameters, will remove all users that
  9304.          have called less than <calls> times and haven't called for
  9305.          <# of days>, and that only have the specified <level>.  This
  9306.          option comes in handy to remove all users that have called just
  9307.          once, but without removing your new users or users with another
  9308.          security level.
  9309.  
  9310.  
  9311.          Examples:
  9312.          ─────────
  9313.  
  9314.             PBUTIL UK -C3           Removes all users that have called only
  9315.                                     1 or 2 times.
  9316.  
  9317.             PBUTIL UK -D365         Removes all users that haven't called
  9318.                                     for the last 365 days.
  9319.  
  9320.             PBUTIL UK -C2 -D100     Removes all users that have called
  9321.                                     less than 2 times, and removes users
  9322.                                     that haven't called in the last 100
  9323.                                     days. "No-Kill" flags in User Records
  9324.                                     will be honored.
  9325.  
  9326.             PBUTIL UK -C3 -D5 -L40  Removes all users that have called less
  9327.                                     than 3 times, and users that have not
  9328.                                     called in 5 days, but only those with a
  9329.                                     security level of 40.
  9330.  
  9331.  
  9332.  
  9333.  
  9334.                                       - 166 -
  9335.  
  9336.  
  9337.  
  9338.          ┌─────────────────────────────────────────────────────────────────┐
  9339.          │ [UP] UserFile Packer                                            │
  9340.          └─────────────────────────────────────────────────────────────────┘
  9341.  
  9342.          Removes all deleted users from USERS.BBS, except the users with
  9343.          the NoKill flag set. Corrupted user records are also removed.
  9344.  
  9345.          Specifying option -R instructs the user packer to reset all
  9346.          Last Read pointers to zero.
  9347.  
  9348.          Specifying option -K will delete the .BAK file created when packing
  9349.          the user file.
  9350.  
  9351.          Do NOT pack the userfile when a user is online!!
  9352.          ────────────────────────────────────────────────
  9353.  
  9354.  
  9355.  
  9356.          ┌─────────────────────────────────────────────────────────────────┐
  9357.          │ [US] UserFile Sorter                                            │
  9358.          └─────────────────────────────────────────────────────────────────┘
  9359.  
  9360.          Sorts the user file by security level and by first name.  Also
  9361.          updates the lastread pointers for the new sorted user file as well
  9362.          as reindexing the user file.
  9363.  
  9364.  
  9365.  
  9366.  
  9367.  
  9368.  
  9369.  
  9370.  
  9371.  
  9372.  
  9373.  
  9374.  
  9375.  
  9376.  
  9377.  
  9378.  
  9379.  
  9380.  
  9381.  
  9382.  
  9383.  
  9384.  
  9385.  
  9386.  
  9387.  
  9388.  
  9389.  
  9390.                                       - 167 -
  9391.  
  9392.  
  9393.  
  9394.          ╔═════════════════════════════════════════════════════════════════╗
  9395.          ╟─── REFERENCE ───────────────────────────────────────────────────╢
  9396.          ╚═════════════════════════════════════════════════════════════════╝
  9397.  
  9398.  
  9399.          ┌─────────────────────────────────────────────────────────────────┐
  9400.          │ Multi-user Operation                                            │
  9401.          └─────────────────────────────────────────────────────────────────┘
  9402.  
  9403.          Since ProBoard is a multi-line BBS package, it allows you the
  9404.          ability to have more than one user use the userfile and the
  9405.          message base at the same time.  ProBoard doesn't do any internal
  9406.          multi-tasking to make the program act as flexible as possible.
  9407.  
  9408.          This makes sure that you can set up a multi-line BBS via a network
  9409.          and multiple computers, or by running ProBoard under a multitasking
  9410.          system.  ProBoard is also DESQview aware.
  9411.  
  9412.          ProBoard can handle up to 255 nodes.  Each node needs its own
  9413.          directory, because ProBoard supports the use of many different
  9414.          external message editors and most of these editors are designed
  9415.          to be used on single-node systems.  One editor that does not need
  9416.          such a configuration is GEDIT.  With GEDIT, you simply place one
  9417.          copy of it in your ProBoard startup directory (or any other
  9418.          directory of your choice) and then specify where the editor is
  9419.          located in PROCFG, [F1], Paths, under the "Editor Command" option.
  9420.          A few other newer style editors also support multi-line use
  9421.          without needing a copy in each nodes directory.  To find out more,
  9422.          ask one of the support BBS's.
  9423.  
  9424.          Each node MUST be started from its own private directory.
  9425.                    ────────────────────────────
  9426.  
  9427.          No ProBoard-related files have to be placed in this directory
  9428.          but certain doors and certain message editors may need this
  9429.          directory for their own use.
  9430.  
  9431.          If you want to install 3 nodes in a network, you could create
  9432.          the following structure:
  9433.  
  9434.              C:\PB\MSGBASE           Message base directory
  9435.              C:\PB\TXTFILES          Textfiles directory
  9436.              C:\PB\MENUS             Menus directory
  9437.              C:\PB\PEX               PEX files directory
  9438.  
  9439.              C:\PB\NODE1             Start-up directory for node 1
  9440.              C:\PB\NODE2             Start-up directory for node 2
  9441.              C:\PB\NODE3             Start-up directory for node 3
  9442.  
  9443.  
  9444.  
  9445.  
  9446.                                       - 168 -
  9447.  
  9448.  
  9449.  
  9450.          ProBoard should be started from C:\PB\NODE1 for node 1, from
  9451.          C:\PB\NODE2 for node 2, etc.  These directories may require the
  9452.          files for the external editor.  All the other files that ProBoard
  9453.          uses, should be stored in ProBoard's system directory (usually
  9454.          C:\PB).
  9455.  
  9456.          If you run ProBoard under a multitasker like DESQview, the
  9457.          different nodes MUST be run on different com-ports.  It should
  9458.          be noted that the new DESQview v2.6 supports networks like Novell
  9459.          Lite and Lantastic directly, making it possible to run the BBS
  9460.          on a machine that is also a server.  Refer to your DESQview v.26
  9461.          manual/setup program for more details.
  9462.  
  9463.  
  9464.          ┌───────────┬─────────────────────────────────────────────────────┐
  9465.          │ IMPORTANT │ If you are running ProBoard multi-line using a      │
  9466.          ├───────────┘ multitasker, the DOS program SHARE.EXE MUST! be     │
  9467.          │             installed.                             ────         │
  9468.          └─────────────────────────────────────────────────────────────────┘
  9469.  
  9470.  
  9471.  
  9472.          ┌─────────────────────────────────────────────────────────────────┐
  9473.          │ SysOp Keys                                                      │
  9474.          └─────────────────────────────────────────────────────────────────┘
  9475.  
  9476.          While the user is on-line, the SysOp can perform several actions,
  9477.          by using the SysOp keys:
  9478.  
  9479.  
  9480.          <Ctrl-Left-Arrow>             Lower or Raise the security level of
  9481.          <Ctrl-Right-Arrow>            the user who is currently online.
  9482.                                        Only the levels you previously
  9483.                                        configured in PROCFG can be
  9484.                                        selected.
  9485.  
  9486.          Up/Down                       Raise/Lower the current user's time
  9487.                                        left. The time subtracted/added is
  9488.                                        not restricted to this session!
  9489.  
  9490.          Alt-C   [Chat]                Start a chat with the user. The chat
  9491.                                        may be ended by pressing <Esc>.
  9492.  
  9493.          Alt-J   [Jump]                Jump to DOS. If 'Swapping' was set to
  9494.                                        'Yes' in PROCFG, the ProBoard session
  9495.                                        will be swapped to disk or EMS, thus
  9496.                                        making all memory available to the
  9497.                                        DOS commands you want to execute.
  9498.                                        You can return from the shell by
  9499.                                        entering EXIT at the DOS prompt.
  9500.  
  9501.  
  9502.                                       - 169 -
  9503.  
  9504.  
  9505.  
  9506.          Alt-H   [HangUp]              Hangs up the phone, throwing the
  9507.                                        user off-line immediately
  9508.                                        (very unfriendly)!
  9509.  
  9510.          Alt-L   [LockOut]             Hangs up the phone AND sets the
  9511.                                        user's level to 0, thus making sure
  9512.                                        he/she cannot log in any more
  9513.                                        (very very unfriendly)!
  9514.  
  9515.          Alt-N   [SysOp Next]          Creates a semaphore file called
  9516.                                        SysOpNXT.SEM in the ProBoard system
  9517.                                        directory.  Also will play the music
  9518.                                        file SysOpNXT.MUS when user logs off
  9519.                                        so you are aware your BBS is free.
  9520.  
  9521.          Alt-E   [Edit]                Allows you to edit the user
  9522.                                        online. The editor is similar to
  9523.                                        the editor in ProCFG.
  9524.  
  9525.          Alt-I   [Image]               Appends an image of the screen to
  9526.                                        the file IMAGE.TXT in the ProBoard
  9527.                                        system directory.
  9528.  
  9529.          Alt-R  [Reset]                Resets the chat request status. This
  9530.                                        will stop the flashing of the status
  9531.                                        line.
  9532.  
  9533.          Alt-S  [Static]               What can I say.  Useful in
  9534.                                        combination with the ALT-H to help
  9535.                                        you, the friendly SysOp, free up
  9536.                                        your board when needed.  (somewhat
  9537.                                        friendlier) ;-)
  9538.  
  9539.          Alt-Y  [No Chat]              Makes ProBoard not sound the page
  9540.                                        music if the user online when you
  9541.                                        press this, pages you.  Comes in
  9542.                                        very handy when you see that user
  9543.                                        who ALWAYS wants to chat is logging
  9544.                                        on to your BBS.
  9545.  
  9546.          Shift-F1                      Shows a help-screen with all the
  9547.                                        SysOp macros available.  (registered
  9548.                                        version only)
  9549.  
  9550.          F1                            Shows a help-screen with all the
  9551.                                        SysOp keys available.
  9552.  
  9553.  
  9554.  
  9555.  
  9556.  
  9557.  
  9558.                                       - 170 -
  9559.  
  9560.  
  9561.  
  9562.          PgUp/PgDn                     Shows additional information about
  9563.                                        the current user on the status line.
  9564.                                        You can also display a particular
  9565.                                        status by pressing F2-F10.
  9566.  
  9567.          Home                          Shows the normal status line after
  9568.                                        using PgUp/PgDn.
  9569.  
  9570.          F2                            Shows the user's name, level, time
  9571.                                        left and time online.
  9572.  
  9573.          F3                            Shows the user's handle and flags.
  9574.  
  9575.          F4                            Shows the user's city and phone
  9576.                                        numbers.
  9577.  
  9578.          F5                            Shows statistics about the
  9579.                                        current user.
  9580.  
  9581.          F6                            Shows the user's comment line.
  9582.  
  9583.          F7                            Shows system information.
  9584.  
  9585.          F8                            Shows the chat reason if the user
  9586.                                        tried to page the SysOp earlier.
  9587.  
  9588.          F9                            Shows the name and login time of the
  9589.                                        last caller.
  9590.  
  9591.          F10                           Shows the time used and Kbytes
  9592.                                        downloaded today. It also displays
  9593.                                        the date of birth of the current user.
  9594.  
  9595.  
  9596.          Furthermore, there are 10 programmable hotkeys (SysOp macros).
  9597.          They can be configured in ProCFG using the F10 option.
  9598.  
  9599.  
  9600.  
  9601.          ┌─────────────────────────────────────────────────────────────────┐
  9602.          │ Command line parameters & Errorlevels                           │
  9603.          └─────────────────────────────────────────────────────────────────┘
  9604.  
  9605.          PROBOARD.EXE accepts following command line parameters:
  9606.  
  9607.  
  9608.          PROBOARD [-B<baud>] [-P<port>] [-N<node>] [-L<level]
  9609.  
  9610.                   [-T<time>] [-S] [-Q] [-X] [-V<mode>]
  9611.  
  9612.  
  9613.  
  9614.                                       - 171 -
  9615.  
  9616.  
  9617.  
  9618.          These parameters have the following meaning:
  9619.  
  9620.             -B<baud>   Specifies the baud rate. You can specify the
  9621.                        following baud rates: 300, 1200/75 2400, 4800, 7200,
  9622.                        9600, 12000, 14400, 16800, 19200, 21600, 24000,
  9623.                        26400, 28800, 38400, 57600, 64000, and 115200.
  9624.  
  9625.  
  9626.             -P<port>   Specifies the com-port (1-8).
  9627.  
  9628.             -N<node>   This node's node number (1-255).
  9629.  
  9630.             -L<level>  Prevents people with a security level lower than this
  9631.                        level to access this node.  Great for only allowing
  9632.                        subscribing user access to one or more nodes.
  9633.  
  9634.             -T<time>   <time> is the time until the next event in minutes.
  9635.                        Useful with FrontDoor's DOBBS batch file.
  9636.  
  9637.             -S         Start ProBoard in stand alone mode.  ProBoard will
  9638.                        use as a default the PORT and the BAUD specified
  9639.                        in your configuration, but you can override them
  9640.                        by using the -P<port> and the -B<baud> command line
  9641.                        parameters along with the -S parameter.
  9642.  
  9643.             -Q         Quiet mode.  Great if your BBS is in a location such
  9644.                        as your bedroom etc.  The only noise ProBoard will
  9645.                        make is playing the ATTEN.MUS file (if a user who
  9646.                        has this set in their user record logs on), and
  9647.                        playing the PAGE tune when a user pages during valid
  9648.                        paging hours.
  9649.  
  9650.             -X         Tells ProBoard not to use EMS.
  9651.  
  9652.             -V<mode>   Runs ProBoard in video mode <mode>. This can be
  9653.                        useful if you have a monitor capable of displaying
  9654.                        132 columns, and you would like to run ProBoard in
  9655.                        such a mode (you will see an extra information
  9656.                        window on your screen if ProBoard is run in
  9657.                        132 cols mode). The <mode> parameter is a decimal
  9658.                        number specifying the video mode, as it is used with
  9659.                        INT 10H, function 00. (only programmers will
  9660.                        understand this though :-).  This is different for
  9661.                        every video card.
  9662.  
  9663.          When no '-B<x>' and no '-S' parameter is given, ProBoard will be
  9664.          started in local mode.
  9665.  
  9666.  
  9667.  
  9668.  
  9669.  
  9670.                                       - 172 -
  9671.  
  9672.  
  9673.  
  9674.          ProBoard returns an errorlevel when a user has logged off.
  9675.  
  9676.          The errorlevels of PROBOARD.EXE are:
  9677.          ────────────────────────────────────
  9678.  
  9679.               0    Everything OK, normal logoff.
  9680.  
  9681.               1    FATAL error, something 'terrible' happened, or the
  9682.                    modem could not be initialized.
  9683.  
  9684.               2    Not used.
  9685.  
  9686.               3    Netmail entered by the user.
  9687.  
  9688.               4    Echomail entered by the user.
  9689.  
  9690.               5    Echomail AND Netmail entered by the user.
  9691.  
  9692.              99    SysOp pressed <Esc> at the "Waiting for call" screen.
  9693.  
  9694.             100    ProBoard was requested to go down by a semaphore file.
  9695.  
  9696.  
  9697.  
  9698.          ┌─────────────────────────────────────────────────────────────────┐
  9699.          │ AVATAR/0 and AVATAR/0+ Terminal Emulation                       │
  9700.          └─────────────────────────────────────────────────────────────────┘
  9701.  
  9702.          ProBoard now supports AVATAR terminal emulation.  It allows users
  9703.          to select either AVATAR/0 or AVATAR/0+, providing that the terminal
  9704.          package they use to call your BBS is compatible with either
  9705.          AVATAR/0 and/or AVATAR/0+.  Examples of terminal software packages
  9706.          that support AVATAR/0+ are, FrontDoor 2.02 and TinyTerm.
  9707.          QModem and Telix also support AVATAR, but only in the AVATAR/0
  9708.          mode.  AVATAR has the advantage over ANSI of being much faster.
  9709.  
  9710.          A word about the files extensions (.A??) that are used for AVATAR
  9711.          screens.  There are two file extensions that are associated with
  9712.          AVATAR text files that you will display to your users.  They are
  9713.          .AVT and .AVP.  When displaying (.A??) textfiles to your users,
  9714.          ProBoard looks for them in the following order.
  9715.  
  9716.            1.) .AVP
  9717.            2.) .AVT
  9718.            3.) .ANS
  9719.            4.) .ASC
  9720.  
  9721.         Refer to the following section on "Hard Coded .A?? files" for more
  9722.         information on the default .A?? files that ProBoard will display to
  9723.         your users.
  9724.  
  9725.  
  9726.                                       - 173 -
  9727.  
  9728.  
  9729.  
  9730.         To create files with the .AVT and .AVP file extensions you will
  9731.         need a file utility called AVTCONV.EXE.  This file was distributed
  9732.         with RemoteAccess, and is also available from most of the ProBoard
  9733.         beta sites, as well as any of the ProBoard Support BBS's.  It is
  9734.         very simple to use this utility.  Just copy it to your ProBoard
  9735.         TEXTFILE directory and run the following commands:
  9736.  
  9737.         AVTCONV *.ANS AVT       -- this will create a copy of all of your
  9738.                                 ANSI (.ANS) screens with the extension .AVT
  9739.                                 These are the textfiles for displaying to
  9740.                                 users that have AVATAR/0 terminal emulation
  9741.                                 selected.
  9742.  
  9743.         AVTCONV /C+ *.ANS AVP   -- this will create a copy of all of your
  9744.                                 ANSI (.ANS) screens with the extension .AVP
  9745.                                 These are the textfiles for displaying to
  9746.                                 users that have AVATAR/0+ terminal emulation
  9747.                                 selected.
  9748.  
  9749.  
  9750.  
  9751.          ┌─────────────────────────────────────────────────────────────────┐
  9752.          │ Hard-coded .A?? files                                           │
  9753.          └─────────────────────────────────────────────────────────────────┘
  9754.  
  9755.          In certain situations, ProBoard will display default .A?? files.
  9756.  
  9757.          Just what is an A?? file?
  9758.  
  9759.          All .A?? files are files that have the file extensions of .AVT,
  9760.          .AVP, .ANS, or .ASC.  If the .ANS/AVT/AVP file cannot be found,
  9761.          the .ASC file will be displayed (if it exists).
  9762.  
  9763.          Note: You have to insert your own "Press [Enter] to continue"
  9764.          prompt if necessary!
  9765.  
  9766.  
  9767.          AFTERPW.A??    Displayed to a user after they have entered their
  9768.                         password.
  9769.  
  9770.          BEFOREPW.A??   Displayed to a user right before ProBoard asks
  9771.                         them for their password.
  9772.  
  9773.          BIRTHDAY.A??   If a user logs in on his/her birthday, this
  9774.                         file will be shown after the news file.
  9775.                         Note: you can run a pex-file to congratulate a
  9776.                         user on his/her birthday.
  9777.  
  9778.  
  9779.  
  9780.  
  9781.  
  9782.                                       - 174 -
  9783.  
  9784.  
  9785.  
  9786.          DLDELAY.A??    Displayed to a user who has to wait <n> minutes
  9787.                         before downloading. Refer to Configuration -
  9788.                         Time/DownLoad Limits (F5) for more information on
  9789.                         setting the number of minutes for the DownLoad
  9790.                         Delay.
  9791.  
  9792.          DLHANGUP.A??   Displayed to a user who has selected [G]oodbye
  9793.                         after download, after the 10 second timer to
  9794.                         abort the hangup, has expired.
  9795.  
  9796.          DUPESFND.A??   Displayed to a user who uploads one or more
  9797.                         duplicate files to your BBS if "Check Duplicate
  9798.                         Uploads" is set to "Yes" in PROCFG's File Transfer
  9799.                         Options.  The file will be displayed to the user
  9800.                         once the duplicate check is completed if any
  9801.                         duplicate files are found.
  9802.  
  9803.          EVENTDUE.A??   Shown if a user can't login because of an event
  9804.                         that has to run soon.
  9805.  
  9806.          EXPIRED.A??    When a user's level has expired, this file is
  9807.                         shown.
  9808.  
  9809.          EXP_WARN.A??   Displayed when the user's level expires within
  9810.                         less than 30 days.
  9811.  
  9812.          GOODBYE.A??    Displayed when the user is logging off, just
  9813.                         before the carrier is dropped.
  9814.  
  9815.          INTRO.A??      Displayed when a user logs in, BEFORE asking a
  9816.                         user's name and password.
  9817.  
  9818.          INTRO<n>.A??   This is the same as INTRO.ASC/ANS except that
  9819.                         this file that can be displayed to the specified
  9820.                         node number.  For Example: to display it to node 2
  9821.                         you would create a file called INTRO2.A??.  If
  9822.                         no INTRO<n>.A?? exists, ProBoard will then show the
  9823.                         file INTRO.A?? or LOGO.A??
  9824.  
  9825.          MAXPAGE.A??    Displayed when the user has tried to page the
  9826.                         SysOp too many times.
  9827.  
  9828.          MSGHELP.A??    Replaces the built-in message reading help if
  9829.                         this file exists.
  9830.  
  9831.          NEWS.A??       Displayed AFTER the user has read his/her
  9832.                         new mail.
  9833.  
  9834.  
  9835.  
  9836.  
  9837.  
  9838.                                       - 175 -
  9839.  
  9840.  
  9841.  
  9842.          NEWUSER.A??    Displayed to user before ProBoard asks "Are you
  9843.                         a New User?".  When the user enters their name
  9844.                         and ProBoard does not find their name in the
  9845.                         user file, ProBoard asks "Did you enter your name
  9846.                         correctly?"  If the user indicates they did, this
  9847.                         file (if you create it) will display to the user.
  9848.  
  9849.          NEWUSER1.A??   Displayed when a new user is logging in,
  9850.                         BEFORE he/she has started the questionnaire.
  9851.  
  9852.          NEWUSER2.A??   Displayed when a new user is logging in, AFTER
  9853.                         he/she has completed the questionnaire.
  9854.  
  9855.          NOACCESS.A??   Displayed when user is not allowed to log onto
  9856.                         one or more lines because their access level is
  9857.                         lower than the one specified in the command line
  9858.                         PROBOARD -L<level> (used to start ProBoard on that
  9859.                         node).  Read the "Reference Section" of this
  9860.                         manual, under "Command Line Options & Errorlevels"
  9861.                         for more information on this command line.
  9862.  
  9863.          NOTAVAIL.A??   Displayed when the user tries to page outside
  9864.                         paging hours.
  9865.  
  9866.  
  9867.          PAGED.A??      Displayed when the SysOp does not respond when
  9868.                         the user tries to page.
  9869.  
  9870.          PRIVATE.A??    Is displayed when your system is configured as a
  9871.                         private system, and a new user tries to log in.
  9872.  
  9873.          SECxx.A??      'xx' stands for a userlevel. If a user with
  9874.                         level xx logs in, this file will be displayed
  9875.                         (eg. SEC25.ANS). The file is shown after all
  9876.                         WELCOME<x> files and before the mailcheck.
  9877.  
  9878.          TRASHCAN.A??   Shown when a user tries to use a name listed
  9879.                         in TRASHCAN.CTL file.
  9880.  
  9881.          WELCOMEx.A??   Displayed at login, after the user entered
  9882.                         his/her name.  The 'x' stands for a digit
  9883.                         ranging from 1 to 9; these files (if they
  9884.                         exist) will be displayed in ascending order,
  9885.                         1-2-...-9, BEFORE a mailcheck is done.
  9886.  
  9887.  
  9888.  
  9889.  
  9890.  
  9891.  
  9892.  
  9893.  
  9894.                                       - 176 -
  9895.  
  9896.  
  9897.  
  9898.          ┌─────────────────────────────────────────────────────────────────┐
  9899.          │ .A?? File Control Codes                                         │
  9900.          └─────────────────────────────────────────────────────────────────┘
  9901.  
  9902.          You can use several codes in ProBoard's textfiles. These codes
  9903.          will be replaced by internal variables, or will perform special
  9904.          actions.
  9905.  
  9906.          In the code list, you will see a code's ASCII value, the control
  9907.          code and a description of the code.
  9908.  
  9909.          A '^' means Ctrl, so ^D means Ctrl-D.
  9910.  
  9911.  
  9912.          ┌───────┬──────┬──────────────────────────────────────────────────┐
  9913.          │ ASCII │ CODE │  DESCRIPTION                                     │
  9914.          └───────┴──────┴──────────────────────────────────────────────────┘           65     ^A
  9915.              65     ^A    Waits for the user to press <Enter>.
  9916.              66     ^B    Disables interruption by pressing <S>.
  9917.              67     ^C    Enables interruption by pressing <S>.
  9918.              68     ^D    Enables 'More'-prompt.
  9919.              69     ^E    Disables 'More'-prompt.
  9920.              71     ^G    Rings a bell on the user's computer.
  9921.              76     ^L    Clearscreen.
  9922.              87     ^W    Pauses for 1 second.
  9923.  
  9924.  
  9925.  
  9926.  
  9927.  
  9928.  
  9929.  
  9930.  
  9931.  
  9932.  
  9933.  
  9934.  
  9935.  
  9936.  
  9937.  
  9938.  
  9939.  
  9940.  
  9941.  
  9942.  
  9943.  
  9944.  
  9945.  
  9946.  
  9947.  
  9948.  
  9949.  
  9950.                                       - 177 -
  9951.  
  9952.  
  9953.  
  9954.          ┌───────┬──────┬──────────────────────────────────────────────────┐
  9955.          │ ASCII │ CODE │  DESCRIPTION                                     │
  9956.          └───────┴──────┴──────────────────────────────────────────────────┘
  9957.            06-65   ^FA    User's full name.
  9958.            06-66   ^FB    User's City.
  9959.            06-67   ^FC    User's password.
  9960.            06-68   ^FD    User's data/fax phone number.
  9961.            06-69   ^FE    User's phone number.
  9962.            06-71   ^FG    Time of last login.
  9963.            06-76   ^FL    Netmail credit left.
  9964.            06-77   ^FM    Number of messages written.
  9965.            06-78   ^FN    Message last read.
  9966.            06-79   ^FO    User's level.
  9967.            06-80   ^FP    Number of calls by user.
  9968.            06-81   ^FQ    Number of uploads by user.
  9969.            06-82   ^FR    Kbytes uploaded by user.
  9970.            06-83   ^FS    Number of downloads by user.
  9971.            06-84   ^FT    Kbytes downloaded by user.
  9972.            06-85   ^FU    Number of minutes online today.
  9973.            06-86   ^FV    User's screen length.
  9974.            06-87   ^FW    User's first name.
  9975.            06-88   ^FX    ANSI codes ON/OFF.
  9976.            06-89   ^FY    Screen pausing ON/OFF.
  9977.            06-90   ^FZ    Clearscreen codes ON/OFF.
  9978.            06-48   ^F0    Fullscreen editor ON/OFF.
  9979.            06-49   ^F1    User's Alias.
  9980.            06-50   ^F2    Command stacking ON/OFF.
  9981.            06-51   ^F3    IBM Characters ON/OFF.
  9982.            06-52   ^F4    User's State.
  9983.            06-53   ^F5    User's birth date.
  9984.            06-54   ^F6    User's expiration date (if any)
  9985.            06-55   ^F7    Day's until expiration date.
  9986.            06-56   ^F8    AVATAR/0  - on/off.
  9987.            06-57   ^F9    AVATAR/0+  - on/off.
  9988.            06-40   ^F"    User's Country.
  9989.            06-58   ^F:    User's first call (date).
  9990.            06-36   ^F$    User's address (line 1).
  9991.            06-37   ^F'    User's address (line 2).
  9992.            06-38   ^F&    User's address (line 3).
  9993.            06-60   ^F`    User's sex.
  9994.            06-91   ^F[    Download Kb left today.
  9995.            06-126  ^F~    Download delay in minutes.
  9996.            06-33   ^F!    # Minutes remaining until allowed to download.
  9997.            06-40   ^F(    Current file group name.
  9998.            06-41   ^F)    Current message group name.
  9999.            06-42   ^F*    Current file group number.
  10000.            06-43   ^F+    Current message group number.
  10001.            06-61   ^F=    User's fax number
  10002.  
  10003.  
  10004.  
  10005.  
  10006.                                       - 178 -
  10007.  
  10008.  
  10009.  
  10010.          ┌───────┬──────┬──────────────────────────────────────────────────┐
  10011.          │ ASCII │ CODE │   DESCRIPTION                                    │
  10012.          └───────┴──────┴──────────────────────────────────────────────────┘
  10013.            11-65   ^KA    Total number of calls to the BBS.
  10014.            11-66   ^KB    Name of the last user on the BBS.
  10015.            11-67   ^KC    Number of active Hudson message base messages.
  10016.            11-68   ^KD    Number of first message.
  10017.            11-69   ^KE    Number of last message.
  10018.            11-70   ^KF    Number of times user has paged the SysOp.
  10019.            11-71   ^KG    Day of the week (full).
  10020.            11-72   ^KH    Number of users on the BBS.
  10021.            11-73   ^KI    Current time.
  10022.            11-74   ^KJ    Today's date.
  10023.            11-75   ^KK    Minutes online during this session.
  10024.            11-77   ^KM    Minutes online today.
  10025.            11-79   ^KO    Minutes online left today.
  10026.            11-80   ^KP    Version number of ProBoard (x.xx)
  10027.            11-81   ^KQ    Daily online limit.
  10028.            11-82   ^KR    Baud rate.
  10029.            11-83   ^KS    Day of the week (short).
  10030.            11-84   ^KT    Daily download limit (Kbytes).
  10031.            11-87   ^KW    Node number.
  10032.            11-88   ^KX    Hang up phone.
  10033.            11-89   ^KY    Active message area name.
  10034.            11-90   ^KZ    Active file area name.
  10035.            11-48   ^K0    # Messages in active message area
  10036.            11-49   ^K1    Current message area #
  10037.            11-50   ^K2    Current file area #
  10038.  
  10039.  
  10040.  
  10041.          You can also inform ProBoard about the length of a string to be
  10042.          placed in a textfile. This is done is the following way:
  10043.  
  10044.          Between the first and last code, you can place '@' or '#' or
  10045.          '%' codes.  The field's length will be defined by the number of
  10046.          characters, first and last control code included.
  10047.          Use '@' to align (justify) a field to the left, use '#' to align
  10048.          to the right and use '%' to center a field.
  10049.  
  10050.  
  10051.              Eg. ^K@@@@@@@@@@@@@@@@@@@@@@@B
  10052.                   ^^^^^^^^^^^^^^^^^^^^^^^
  10053.                         23 X '@'
  10054.  
  10055.          Thus, the total amount of characters equals 25, the user's name
  10056.          (^KB) will be placed in a 25-character field, left justified. You
  10057.          now can easily draw 'boxes' around this field, without having to
  10058.          worry about the actual length of the user's name.
  10059.  
  10060.  
  10061.  
  10062.                                       - 179 -
  10063.  
  10064.  
  10065.  
  10066.          An example of a textfile using the control codes: (the '^' stands
  10067.          for '^F') :
  10068.  
  10069.  
  10070.           ┌───────────┐
  10071.           │ Some Info │
  10072.           └───┬───────┴───────────────────────────────────────────────────┐
  10073.               │ Your full name..... ^@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@A    │
  10074.               │ Calling from....... ^@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@B    │
  10075.               │ Last called........ ^@@@@@@@@@F at ^@@@@@@G               │
  10076.               │ Level.............. ^####O                                │
  10077.               │ Number of calls.... ^####P                                │
  10078.               ├──────────────────────────────┬────────────────────────────┤
  10079.               │ Kb downloaded...... ^@@@@TK  │ Kb uploaded....... ^####RK │
  10080.               │ # downloads........ ^####S   │ # uploads......... ^####Q  │
  10081.               ├──────────────────────────────┴────────────────────────────┤
  10082.               │ Messages posted.... ^####M                                │
  10083.               │ Your flags......... ^@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@H    │
  10084.               ├─────────────────┐                                         │
  10085.               │ ANSI        ^#X ├─────────────────────────────────────────┘
  10086.               │ Clearscreen ^#Z │
  10087.               │ More prompt ^#Y │
  10088.               │ Editor      ^#O │
  10089.               └─────────────────┘  Press <Enter> to continue.^A
  10090.  
  10091.  
  10092.  
  10093.          ┌─────────────────────────────────────────────────────────────────┐
  10094.          │ Music Files                                                     │
  10095.          └─────────────────────────────────────────────────────────────────┘
  10096.  
  10097.          You can make your paging-sound and attention-sound more attractive
  10098.          by defining your own music file. A music file is a text file in
  10099.          which you can use 2 keywords:
  10100.  
  10101.            TONE [hz] [1/100's sec]      Sounds a tone of [hz] Hz during
  10102.                                         the specified period.
  10103.  
  10104.            WAIT [1/100's sec]           Waits for the specified period.
  10105.  
  10106.  
  10107.          The format of this textfile is compatible with the RemoteAccess
  10108.          musicfiles.
  10109.  
  10110.          The paging-musicfile is named PAGE.MUS, and the attention-music-
  10111.          file is named ATTEN.MUS.
  10112.  
  10113.  
  10114.  
  10115.  
  10116.  
  10117.  
  10118.                                       - 180 -
  10119.  
  10120.  
  10121.  
  10122.          You can use this frequency-table to write your own masterpiece:
  10123.  
  10124.                  ┌──────┬─────┬─────┬──────┬──────┬──────┐
  10125.                  │  O.1 │ O.2 │ O.3 │  O.4 │  O.5 │  O.6 │
  10126.             ┌────┼──────┼─────┼─────┼──────┼──────┼──────┤
  10127.             │ C  │   45 │ 134 │ 268 │  536 │ 1071 │ 2145 │
  10128.             │ C# │   71 │ 142 │ 284 │  568 │ 1136 │ 2273 │
  10129.             │ D  │   75 │ 150 │ 301 │  602 │ 1204 │ 2408 │
  10130.             │ D# │   80 │ 159 │ 319 │  638 │ 1275 │ 2551 │
  10131.             │ E  │   84 │ 169 │ 338 │  676 │ 1351 │ 2703 │
  10132.             │ F  │   90 │ 179 │ 358 │  716 │ 1432 │ 2864 │
  10133.             │ F# │   95 │ 190 │ 379 │  758 │ 1517 │ 3034 │
  10134.             │ G  │  100 │ 201 │ 402 │  804 │ 1607 │ 3215 │
  10135.             │ G# │  106 │ 213 │ 426 │  851 │ 1703 │ 3406 │
  10136.             │ A  │  113 │ 225 │ 451 │  902 │ 1804 │ 3608 │
  10137.             │ A# │  119 │ 239 │ 478 │  956 │ 1991 │ 3823 │
  10138.             │ B  │  127 │ 253 │ 506 │ 1012 │ 2025 │ 4050 │
  10139.             └────┴──────┴─────┴─────┴──────┴──────┴──────┘
  10140.  
  10141.  
  10142.  
  10143.          ┌─────────────────────────────────────────────────────────────────┐
  10144.          │ Text Macros                                                     │
  10145.          └─────────────────────────────────────────────────────────────────┘
  10146.  
  10147.          You can enter text macros in any user-definable string. Text
  10148.          macros are defined as "@<NAME:n>@", and are replaced by internal
  10149.          ProBoard variables at runtime.
  10150.          You can insert these macros in the following strings:
  10151.  
  10152.            - Textlines in menu items
  10153.            - Data fields in menu items
  10154.            - Menu prompts
  10155.            - Modem initialization string
  10156.  
  10157.  
  10158.          'NAME' is the name of the macro. A list of available macros will
  10159.          follow.
  10160.  
  10161.          You can also specify the field width for the resulting string.
  10162.          This is done by appending the macro name with a ':' and a number.
  10163.          A positive number will result in a left aligned string, while a
  10164.          negative number will result in a right aligned string.
  10165.  
  10166.          For example: @<NAME:30>@ will display the user's name in a left
  10167.          aligned field of 30 characters wide.
  10168.  
  10169.          Note that the field width specifier is optional.
  10170.  
  10171.  
  10172.  
  10173.  
  10174.                                       - 181 -
  10175.  
  10176.  
  10177.  
  10178.          Here is a list of the available macros:
  10179.  
  10180.            BAUD              Current baud rate
  10181.            CITY              The city of the current user
  10182.            COUNTRY           User's country/state
  10183.            CURFILEAREA       Current file area name
  10184.            CURFILEAREA#      Current file area number
  10185.            CURFILEAREADIR    Current file area path
  10186.            CURFILEGROUP      Current file group name
  10187.            CURFILEGROUP#     Current file group number
  10188.            CURMENU           Current menu name
  10189.            CURMSGAREA        Current message area name
  10190.            CURMSGAREA#       Current message area number
  10191.            CURMSGGROUP       Current message group name
  10192.            CURMSGGROUP#      Current message group number
  10193.            DATAPHONE         User's data phone number
  10194.            DATE              Current date (xx-xxx-xx)
  10195.            FIRSTNAME         The first name of the current user
  10196.            HANDLE            The user's handle (fixed alias)
  10197.            HIGHMSG           Highest message number in message base
  10198.            ID                The user level ID for this user
  10199.            LANGUAGE          The language of the user (base file name)
  10200.  
  10201.  
  10202.  
  10203.  
  10204.  
  10205.  
  10206.  
  10207.  
  10208.  
  10209.  
  10210.  
  10211.  
  10212.  
  10213.  
  10214.  
  10215.  
  10216.  
  10217.  
  10218.  
  10219.  
  10220.  
  10221.  
  10222.  
  10223.  
  10224.  
  10225.  
  10226.  
  10227.  
  10228.  
  10229.  
  10230.                                       - 182 -
  10231.  
  10232.  
  10233.  
  10234.            LASTDATE          Date of user's last call
  10235.            LASTTIME          Time of user's last call
  10236.            LEVEL             The level of the current user
  10237.            LOWMSG            Lowest message number in message base (Hudson)
  10238.            MNUDIR            Menu directory
  10239.            MSGDIR            Message base directory
  10240.            NAME              The name of the current user
  10241.            NLDIR             Nodelist directory
  10242.            NODE              Current node number
  10243.            NUMMSG            Number of messages in current area
  10244.            NUMUSERS          Total number of users in userfile
  10245.            NUMYELLS          The number of times the user yelled
  10246.            PASSWORD          The user's password
  10247.            PEXDIR            PEX-files directory
  10248.            PORT              Current com-port nr (1-8)
  10249.            PVTDIR            Private uploads directory
  10250.            STARTDIR          Startup-directory
  10251.            SYSDIR            ProBoard system directory
  10252.            SYSOPNAME         Name of the SysOp
  10253.            TIME              Current time (xx:xx)
  10254.            TMLEFT            Number of minutes left
  10255.            TMONLINE          Number of minutes online
  10256.            TOTALCALLS        Total # of calls to the system
  10257.            TOTALMSG          Total # of messages in message base (Hudson)
  10258.            TXTDIR            Textfiles directory
  10259.            UPDIR             Upload directory
  10260.            USERREC           Record number of this user's user record
  10261.            VERSION           ProBoard version number (eg. 2.15)
  10262.            VOICEPHONE        User's voice phone number
  10263.  
  10264.            %NAME             Will be replaced by the contents of DOS
  10265.                              environment variable 'NAME'.
  10266.                              Example: in DOS or a .BAT file you would put
  10267.                                       SET INITSTR=ATDT5551212.  Then when
  10268.                                       you use a text macro like this:
  10269.                                       @<%INITSTR>@ it would be replaced
  10270.                                       with "ATDT5551212".  Note
  10271.                                       the "%" symbol in the macro.
  10272.  
  10273.  
  10274.  
  10275.  
  10276.  
  10277.  
  10278.  
  10279.  
  10280.  
  10281.  
  10282.  
  10283.  
  10284.  
  10285.  
  10286.                                       - 183 -
  10287.  
  10288.  
  10289.  
  10290.            Other special characters are:
  10291.  
  10292.            #1 - #7           Change color (only valid for displayable
  10293.            #B1 - #B7         strings). If a 'B' is in front of the color
  10294.                              number, the "blink" attribute will be turned
  10295.                              on.
  10296.                                      1 = Red
  10297.                                      2 = Green
  10298.                                      3 = Yellow
  10299.                                      4 = Blue
  10300.                                      5 = Magenta
  10301.                                      6 = Cyan
  10302.                                      7 = White
  10303.  
  10304.  
  10305.          Example:  Hi @<#3>@@<FIRSTNAME>@@<#7>@, how is the weather
  10306.          in @<CITY>@?
  10307.  
  10308.          Other single examples:   @<NAME:35>@
  10309.                                   @<TMONLINE:-5>@
  10310.                                   @<CITY>@
  10311.  
  10312.  
  10313.  
  10314.  
  10315.  
  10316.  
  10317.  
  10318.  
  10319.  
  10320.  
  10321.  
  10322.  
  10323.  
  10324.  
  10325.  
  10326.  
  10327.  
  10328.  
  10329.  
  10330.  
  10331.  
  10332.  
  10333.  
  10334.  
  10335.  
  10336.  
  10337.  
  10338.  
  10339.  
  10340.  
  10341.  
  10342.                                       - 184 -
  10343.  
  10344.  
  10345.  
  10346.          ┌─────────────────────────────────────────────────────────────────┐
  10347.          │ Example Batch Files                                             │
  10348.          └─────────────────────────────────────────────────────────────────┘
  10349.  
  10350.          This is an example for standalone-operation with 2 errorlevel
  10351.          events defined. Event 1 returns level 10, event 2 returns level
  10352.          20. No echomail and netmail is used.
  10353.  
  10354.          ------------------------------------------------------------------
  10355.              :Loop
  10356.              PROBOARD -S
  10357.              if errorlevel 100 goto End
  10358.              if errorlevel 99 goto End
  10359.              if errorlevel 20 goto Event2
  10360.              if errorlevel 10 goto Event1
  10361.              if errorlevel 1 goto FatalError
  10362.              goto Loop
  10363.  
  10364.              :Event1
  10365.              echo Perform some actions
  10366.              echo --------------------
  10367.              goto Loop
  10368.  
  10369.              :Event2
  10370.              echo Perform some more actions
  10371.              echo -------------------------
  10372.              goto Loop
  10373.  
  10374.              :FatalError
  10375.              echo FATAL ERROR - ProBoard Down
  10376.              :End
  10377.          ------------------------------------------------------------------
  10378.  
  10379.  
  10380.          Using ProBoard with a frontend-mailer is a little more
  10381.          complicated. This is an example for use with FrontDoor.
  10382.  
  10383.          In this example FrontDoor uses the following errorlevels:
  10384.  
  10385.             300 bps call : 50
  10386.            1200 bps call : 51
  10387.            2400 bps call : 52
  10388.            Local call    : 60
  10389.            Mail received : 100
  10390.            Exit          : 150
  10391.  
  10392.  
  10393.  
  10394.  
  10395.  
  10396.  
  10397.  
  10398.                                       - 185 -
  10399.  
  10400.  
  10401.  
  10402.          ------------------------------------------------------------------
  10403.              SET FD=C:\FD
  10404.  
  10405.              :Loop
  10406.              cd \fd
  10407.              fd
  10408.              if errorlevel 150 goto End
  10409.              if errorlevel 100 goto MailRcv
  10410.              cd\pb
  10411.              if errorlevel  60 goto Local
  10412.              if errorlevel  52 goto Call2400
  10413.              if errorlevel  51 goto Call1200
  10414.              if errorlevel  50 goto Call300
  10415.  
  10416.              :FatalErr
  10417.              echo FATAL ERROR
  10418.              goto End
  10419.  
  10420.              :Call300
  10421.              proboard -b300 -p1
  10422.              goto CheckPBErr
  10423.  
  10424.              :Call1200
  10425.              proboard -b1200 -p1
  10426.              goto CheckPBErr
  10427.  
  10428.              :Call2400
  10429.              proboard -b2400 -p1
  10430.              goto CheckPBErr
  10431.  
  10432.              :Local
  10433.              proboard
  10434.  
  10435.              :CheckPBErr
  10436.              if errorlevel 100 goto End
  10437.              if errorlevel 5 goto NetEcho
  10438.              if errorlevel 4 goto EchoEntered
  10439.              if errorlevel 3 goto NetEntered
  10440.              if errorlevel 1 goto FatalErr
  10441.              goto Loop
  10442.  
  10443.              :NetEcho
  10444.              REM ************************************
  10445.              REM ** Export netmail & echomail here **
  10446.              REM ************************************
  10447.              Goto Loop
  10448.  
  10449.  
  10450.  
  10451.  
  10452.  
  10453.  
  10454.                                       - 186 -
  10455.  
  10456.  
  10457.  
  10458.              :NetEntered
  10459.              REM ************************************
  10460.              REM **      Export netmail here       **
  10461.              REM ************************************
  10462.              Goto Loop
  10463.  
  10464.              :EchoEntered
  10465.              REM ************************************
  10466.              REM **      Export echomail here      **
  10467.              REM ************************************
  10468.              Goto Loop
  10469.  
  10470.              :MailRcv
  10471.              REM ************************************
  10472.              REM **  Unpack and Import mail here   **
  10473.              REM ************************************
  10474.              Goto Loop
  10475.  
  10476.              :End
  10477.          ------------------------------------------------------------------
  10478.  
  10479.  
  10480.  
  10481.          ┌─────────────────────────────────────────────────────────────────┐
  10482.          │ Flag Cross-Reference Chart                                      │
  10483.          └─────────────────────────────────────────────────────────────────┘
  10484.  
  10485.          The following cross-reference chart will help you to easily
  10486.          determine which flags to use for your user records and menus
  10487.          using the ProBoard style (A-Z and 1-6) of flags.
  10488.  
  10489.          Note:  The flag structures in ProBoard are actually no different
  10490.          than those in QuickBBS or RA, they are just expressed in a more
  10491.          "user friendly" format.
  10492.  
  10493.                ╔═══╦═══╤═══╤═══╤═══╤═══╤═══╤═══╤═══╕
  10494.                ║   ║ 1 │ 2 │ 3 │ 4 │ 5 │ 6 │ 7 │ 8 │
  10495.                ╠═══╬═══╧═══╧═══╧═══╧═══╧═══╧═══╧═══╛
  10496.                ║ A ║ A   B   C   D   E   F   G   H
  10497.                ╟───╢
  10498.                ║ B ║ I   J   K   L   M   N   O   P
  10499.                ╟───╢
  10500.                ║ C ║ Q   R   S   T   U   V   W   X
  10501.                ╟───╢
  10502.                ║ D ║ Y   Z   1   2   3   4   5   6
  10503.                ╙───╜
  10504.  
  10505.  
  10506.  
  10507.  
  10508.  
  10509.  
  10510.                                       - 187 -
  10511.  
  10512.  
  10513.  
  10514.          A few flag examples follow:
  10515.  
  10516.                QuickBBS/RA                ProBoard
  10517.                ───────────                ────────
  10518.                    A1                        A
  10519.                    C3                        S
  10520.                    D7                        5
  10521.                    C8                        X
  10522.  
  10523.          well.... you get the idea.
  10524.  
  10525.  
  10526.  
  10527.          ┌─────────────────────────────────────────────────────────────────┐
  10528.          │ FREE Files                                                      │
  10529.          └─────────────────────────────────────────────────────────────────┘
  10530.  
  10531.          Many SysOps have a master file list containing all the files
  10532.          available on their BBS for users to download, or perhaps some
  10533.          virus detection software that they would like to make available to
  10534.          their users without affecting their users download ratio.  Other
  10535.          SysOps may run a support BBS and have certain files they want to
  10536.          make available to callers without regards to how long it takes to
  10537.          download.  ProBoard's powerful "Free File" option(s) can easily
  10538.          accommodate both of these things.
  10539.  
  10540.          It is possible (in addition to marking entire file areas) to
  10541.          specify a list of files that users can download without ProBoard
  10542.          deducting the kilobyte amount of the download from their daily
  10543.          limit.  This would allow you to make one or two (or several) files
  10544.          in a file area as "Free" without making the entire area "Free" to
  10545.          your users.  To accomplish this, create a file called FREEFILE.CTL
  10546.          in the ProBoard system directory (usually C:\PB).  Create this
  10547.          file with an ascii editor such as QEDIT or DOS editor.  Each line
  10548.          in the file should contain the name (do not include the drive and
  10549.          path to the file) and extension of any files you want to make
  10550.          available for FREE.  Wildcards are allowed.
  10551.  
  10552.          An example follows:
  10553.          ───────────────────
  10554.  
  10555.            PB_215.ZIP
  10556.            FILELIST.ZIP
  10557.            *.TXT
  10558.            SCANV86.ZIP
  10559.            PB_STRUC.*
  10560.            LIST.LZH
  10561.  
  10562.  
  10563.  
  10564.  
  10565.  
  10566.                                       - 188 -
  10567.  
  10568.  
  10569.  
  10570.          It is also possible to specify individual files that you want to
  10571.          make available to your callers with no regard for the time it
  10572.          takes a user to download them.  This means that if you have a file
  10573.          that is 1024k, and the user has 1 minute left, the user would still
  10574.          be able to download the file.  This is a valuable feature for
  10575.          SysOps who run a support BBS and want to make individual files
  10576.          available to users without getting hate mail from those users who
  10577.          call long distance and then don't have enough time left or a high
  10578.          enough security level to download support files.  Refer to Menu
  10579.          Function 32 for more details.
  10580.  
  10581.  
  10582.  
  10583.          ┌─────────────────────────────────────────────────────────────────┐
  10584.          │ Semaphore files for shutting down ProBoard                      │
  10585.          └─────────────────────────────────────────────────────────────────┘
  10586.  
  10587.          It is possible to shut down ProBoard by creating a semaphore file
  10588.          in the ProBoard system directory.  The file should be called
  10589.  
  10590.                 DOWN.<node#>       (node# is the node number)
  10591.  
  10592.          When ProBoard finds this file, it will hang up and immediately
  10593.          exit with errorlevel 100.  It will then create a file called
  10594.          ISDOWN.<node#> in the same directory to indicate that ProBoard has
  10595.          been shut down successfully.
  10596.  
  10597.  
  10598.  
  10599.  
  10600.  
  10601.  
  10602.  
  10603.  
  10604.  
  10605.  
  10606.  
  10607.  
  10608.  
  10609.  
  10610.  
  10611.  
  10612.  
  10613.  
  10614.  
  10615.  
  10616.  
  10617.  
  10618.  
  10619.  
  10620.  
  10621.  
  10622.                                       - 189 -
  10623.  
  10624.  
  10625.  
  10626.          ╔═════════════════════════════════════════════════════════════════╗
  10627.          ╟─── TIPS & TRICKS ───────────────────────────────────────────────╢
  10628.          ╚═════════════════════════════════════════════════════════════════╝
  10629.  
  10630.  
  10631.          ┌─────────────────────────────────────────────────────────────────┐
  10632.          │ Navigating Through Menus                                        │
  10633.          └─────────────────────────────────────────────────────────────────┘
  10634.  
  10635.          ProBoard has been created for the novice and experienced user. It
  10636.          supports Opus-like commands and RA/QBBS style hotkeys. Using
  10637.          hotkeys is the easiest way to navigate through the menus. While a
  10638.          menu is being displayed, you can enter any menu command. The
  10639.          displaying of the menu will be stopped, and the corresponding menu
  10640.          function will be executed immediately.
  10641.          The other way to enter menu options is command stacking. This way
  10642.          you can enter several menu commands at a prompt, and execute them
  10643.          all at once by pressing [Enter]. You are not limited to menu
  10644.          commands only. You can enter any key that should be "stacked". A
  10645.          ';' stands for <Enter>.
  10646.          This asks for an example I guess. Suppose you are in a menu where
  10647.          option [E] selects the "Enter Message" function.  Now, if you
  10648.          want to write a private message to the SysOp, using "Test" as a
  10649.          subject, you could enter:
  10650.  
  10651.             ESysOp;Test;Y
  10652.  
  10653.          E          "Enter Message"
  10654.          SysOp      "Write message to" prompt
  10655.          ;          Enter
  10656.          Test       "Subject" prompt
  10657.          ;          Enter
  10658.          Y          Answer to "Private [Y/N]" prompt
  10659.  
  10660.          If you don't like to use command stacking all the time, but want
  10661.          to use it occasionally, you can enter a ';' at any menu prompt,
  10662.          and you will be able to enter a "command stack".
  10663.  
  10664.  
  10665.  
  10666.          ┌─────────────────────────────────────────────────────────────────┐
  10667.          │ The [S] & [P] key                                               │
  10668.          └─────────────────────────────────────────────────────────────────┘
  10669.  
  10670.          You can stop almost any incoming text with the [S] key, and pause
  10671.          with [P] key. To resume a paused text, press [P] again or press
  10672.          the <Enter> key. The SysOp can disable this though.
  10673.  
  10674.  
  10675.  
  10676.  
  10677.  
  10678.                                       - 190 -
  10679.  
  10680.  
  10681.  
  10682.          ┌─────────────────────────────────────────────────────────────────┐
  10683.          │ Online help in each menu                                        │
  10684.          └─────────────────────────────────────────────────────────────────┘
  10685.  
  10686.           You can create help files for each of your menus by doing the
  10687.           following:
  10688.  
  10689.           Create a menu item in your global menu (GLOBAL.PBM) with the
  10690.           hotkey '?', function 5 (Show ASC/ANS file), data "@<CurMenu>@".
  10691.           Now when a user hits '?' in any menu, the file <MENUNAME>.A??
  10692.           will be displayed to the user.
  10693.  
  10694.  
  10695.  
  10696.          ┌─────────────────────────────────────────────────────────────────┐
  10697.          │ Uploading files to the current file area                        │
  10698.          └─────────────────────────────────────────────────────────────────┘
  10699.  
  10700.           Normally, uploads are sent to the predefined upload directory
  10701.           (set in ProCFG/Options/Paths).  You can override this in the
  10702.           upload function by entering a path in the data field.  You can
  10703.           use text macros to send uploads to the CURRENT file area by
  10704.           entering @<CurFileAreaDir>@ in the data field.
  10705.  
  10706.  
  10707.  
  10708.  
  10709.  
  10710.  
  10711.  
  10712.  
  10713.  
  10714.  
  10715.  
  10716.  
  10717.  
  10718.  
  10719.  
  10720.  
  10721.  
  10722.  
  10723.  
  10724.  
  10725.  
  10726.  
  10727.  
  10728.  
  10729.  
  10730.  
  10731.  
  10732.  
  10733.  
  10734.                                       - 191 -
  10735.  
  10736.  
  10737.  
  10738.  
  10739.          ╔═════════════════════════════════════════════════════════════════╗
  10740.          ╟─── SOFTWARE DEVELOPMENT KIT (SDK) ──────────────────────────────╢
  10741.          ╚═════════════════════════════════════════════════════════════════╝
  10742.  
  10743.  
  10744.         Included with ProBoard is the ProBoard Software Development Kit
  10745.         (SDK).  It consists of the files PB_SDK.H, PB_SDK.OBJ and
  10746.         PB_SDK.LIB.
  10747.  
  10748.         The SDK allows C and C++ programmers to write extensions to
  10749.         ProBoard.  The ProBoard Software Development Kit is bundled with
  10750.         ProBoard as free software.  This means that you may use it to write
  10751.         extensions for ProBoard without having to register ProBoard.  The
  10752.         only exception of course, is if you are using ProBoard to run a BBS
  10753.         on a regular basis.
  10754.  
  10755.         The extensions you can write for ProBoard are called "PEX"
  10756.         (ProBoard Executable) files.  You may distribute any ProBoard PEX
  10757.         files you write royalty free.
  10758.  
  10759.         Any PEX files you create with the SDK are run from within ProBoard
  10760.         using Menu Function 60 (Run ProBoard SDK file).
  10761.  
  10762.  
  10763.  
  10764.  
  10765.  
  10766.  
  10767.  
  10768.  
  10769.  
  10770.  
  10771.  
  10772.  
  10773.  
  10774.  
  10775.  
  10776.  
  10777.  
  10778.  
  10779.  
  10780.  
  10781.  
  10782.  
  10783.  
  10784.  
  10785.  
  10786.  
  10787.  
  10788.  
  10789.  
  10790.  
  10791.                                       - 192 -
  10792.